wasapi: support for setting the WASAPI's AudioClientProperties options via PaWasapiStreamInfo struct (__IAudioClient2_INTERFACE_DEFINED__ must be defined by Windows SDK (for Windows 8 and up) to have effect from these new options, otherwise it will be noop)

include/pa_win_wasapi.h

@@ -69,8 +69,8 @@ typedef enum PaWasapiFlags
              method can only provide 15-20ms latency. */
     paWinWasapiPolling                  = (1 << 3),
 
-    /* forces custom thread priority setting. must be used if PaWasapiStreamInfo::threadPriority 
-       is set to custom value. */
+    /* forces custom thread priority setting, must be used if PaWasapiStreamInfo::threadPriority 
+       is set to a custom value */
     paWinWasapiThreadPriority           = (1 << 4)
 }
 PaWasapiFlags;
@@ -91,7 +91,7 @@ typedef void (*PaWasapiHostProcessorCallback) (void *inputBuffer,  long inputFra
                                                void *outputBuffer, long outputFrames,
                                                void *userData);
 
-/* Device role */
+/* Device role. */
 typedef enum PaWasapiDeviceRole
 {
     eRoleRemoteNetworkDevice = 0,
@@ -109,7 +109,7 @@ typedef enum PaWasapiDeviceRole
 PaWasapiDeviceRole;
 
 
-/* Jack connection type */
+/* Jack connection type. */
 typedef enum PaWasapiJackConnectionType
 {
     eJackConnTypeUnknown,
@@ -128,10 +128,10 @@ typedef enum PaWasapiJackConnectionType
 PaWasapiJackConnectionType;
 
 
-/* Jack geometric location */
+/* Jack geometric location. */
 typedef enum PaWasapiJackGeoLocation
 {
-	eJackGeoLocUnk = 0,
+    eJackGeoLocUnk = 0,
     eJackGeoLocRear = 0x1, /* matches EPcxGeoLocation::eGeoLocRear */
     eJackGeoLocFront,
     eJackGeoLocLeft,
@@ -151,7 +151,7 @@ typedef enum PaWasapiJackGeoLocation
 PaWasapiJackGeoLocation;
 
 
-/* Jack general location */
+/* Jack general location. */
 typedef enum PaWasapiJackGenLocation
 {
     eJackGenLocPrimaryBox = 0,
@@ -162,7 +162,7 @@ typedef enum PaWasapiJackGenLocation
 PaWasapiJackGenLocation;
 
 
-/* Jack's type of port */
+/* Jack's type of port. */
 typedef enum PaWasapiJackPortConnection
 {
     eJackPortConnJack = 0,
@@ -173,7 +173,7 @@ typedef enum PaWasapiJackPortConnection
 PaWasapiJackPortConnection;
 
 
-/* Thread priority */
+/* Thread priority. */
 typedef enum PaWasapiThreadPriority
 {
     eThreadPriorityNone = 0,
@@ -202,6 +202,42 @@ typedef struct PaWasapiJackDescription
 PaWasapiJackDescription;
 
 
+/* Stream category.
+   Note:
+    - values are equal to WASAPI AUDIO_STREAM_CATEGORY enum
+    - supported since Windows 8.0, noop on earler versions
+    - values 1,2 are deprecated on Windows 10 and not included into enumeration
+*/
+typedef enum PaWasapiStreamCategory
+{
+    eAudioCategoryOther           = 0,
+    eAudioCategoryCommunications  = 3,
+    eAudioCategoryAlerts          = 4,
+    eAudioCategorySoundEffects    = 5,
+    eAudioCategoryGameEffects     = 6,
+    eAudioCategoryGameMedia       = 7,
+    eAudioCategoryGameChat        = 8,
+    eAudioCategorySpeech          = 9,
+    eAudioCategoryMovie           = 10,
+    eAudioCategoryMedia           = 11
+}
+PaWasapiStreamCategory;
+
+
+/* Stream option.
+   Note:
+    - values are equal to WASAPI AUDCLNT_STREAMOPTIONS enum
+    - supported since Windows 8.1, noop on earler versions
+*/
+typedef enum PaWasapiStreamOption
+{
+    eStreamOptionNone        = 0, //!< default
+    eStreamOptionRaw         = 1, //!< bypass WASAPI Audio Engine DSP effects, supported since Windows 8.1
+    eStreamOptionMatchFormat = 2  //!< force WASAPI Audio Engine into a stream format, supported since Windows 10
+}
+PaWasapiStreamOption;
+
+
 /* Stream descriptor. */
 typedef struct PaWasapiStreamInfo 
 {
@@ -235,6 +271,12 @@ typedef struct PaWasapiStreamInfo
        to setup thread priority.
     */
     PaWasapiThreadPriority threadPriority;
+
+    /* Stream category. */
+    PaWasapiStreamCategory streamCategory;
+
+    /* Stream option. */
+    PaWasapiStreamOption streamOption;
 } 
 PaWasapiStreamInfo;
 
@@ -303,7 +345,7 @@ PaError PaWasapi_GetFramesPerHostBuffer( PaStream *pStream, unsigned int *nInput
 
 /** Get number of jacks associated with a WASAPI device.  Use this method to determine if
     there are any jacks associated with the provided WASAPI device.  Not all audio devices
-	will support this capability.  This is valid for both input and output devices.
+    will support this capability.  This is valid for both input and output devices.
  @param  nDevice  device index.
  @param  jcount   Number of jacks is returned in this variable
  @return Error code indicating success or failure
@@ -314,9 +356,9 @@ PaError PaWasapi_GetJackCount(PaDeviceIndex nDevice, int *jcount);
 
 /** Get the jack description associated with a WASAPI device and jack number
     Before this function is called, use PaWasapi_GetJackCount to determine the
-	number of jacks associated with device.  If jcount is greater than zero, then
-	each jack from 0 to jcount can be queried with this function to get the jack
-	description.
+    number of jacks associated with device.  If jcount is greater than zero, then
+    each jack from 0 to jcount can be queried with this function to get the jack
+    description.
  @param  nDevice  device index.
  @param  jindex   Which jack to return information
  @param  KSJACK_DESCRIPTION This structure filled in on success.
@@ -347,7 +389,7 @@ PaError PaWasapi_GetJackDescription(PaDeviceIndex nDevice, int jindex, PaWasapiJ
         This is the most powerful WASAPI implementation which provides glitch-free
         audio at around 3ms latency in Exclusive mode. Lowest possible latency for this mode is 
         3 ms for HD Audio class audio chips. For the Shared mode latency can not be 
-		lower than 20 ms.
+        lower than 20 ms.
 
         2) Poll-Driven:
         Polling is another 2-nd method to operate with WASAPI. It is less efficient than Event-Driven