include/xaudio2.idl

   1 /*
   2  * Copyright (c) 2015 Mark Harmstone
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 import "unknwn.idl";
  20 import "mmdeviceapi.idl";
  21
  22 import "audiosessiontypes.h";
  23
  24 cpp_quote("#include <pshpack1.h>")
  25
  26 [
  27     uuid(5a508685-a254-4fba-9b82-9a24b00306af)
  28 ]
  29 coclass XAudio2 {
  30     interface IUnknown;
  31 }
  32
  33 [
  34     uuid(db05ea35-0329-4d4b-a53a-6dead03d3852)
  35 ]
  36 coclass XAudio2Debug {
  37     interface IUnknown;
  38 }
  39
  40 cpp_quote("#if 0")
  41 typedef struct WAVEFORMATEX
  42 {
  43     WORD wFormatTag;
  44     WORD nChannels;
  45     DWORD nSamplesPerSec;
  46     DWORD nAvgBytesPerSec;
  47     WORD nBlockAlign;
  48     WORD wBitsPerSample;
  49     WORD cbSize;
  50 } WAVEFORMATEX;
  51
  52 typedef struct {
  53     WAVEFORMATEX    Format;
  54     union {
  55         WORD        wValidBitsPerSample;
  56         WORD        wSamplesPerBlock;
  57         WORD        wReserved;
  58     } Samples;
  59     DWORD           dwChannelMask;
  60     GUID            SubFormat;
  61 } WAVEFORMATEXTENSIBLE, *PWAVEFORMATEXTENSIBLE;
  62 cpp_quote("#else")
  63 cpp_quote("#include <mmreg.h>")
  64 cpp_quote("#endif")
  65
  66 interface IXAudio2Voice;
  67
  68 typedef enum XAUDIO2_WINDOWS_PROCESSOR_SPECIFIER
  69 {
  70     Processor1  = 0x00000001,
  71     Processor2  = 0x00000002,
  72     Processor3  = 0x00000004,
  73     Processor4  = 0x00000008,
  74     Processor5  = 0x00000010,
  75     Processor6  = 0x00000020,
  76     Processor7  = 0x00000040,
  77     Processor8  = 0x00000080,
  78     Processor9  = 0x00000100,
  79     Processor10 = 0x00000200,
  80     Processor11 = 0x00000400,
  81     Processor12 = 0x00000800,
  82     Processor13 = 0x00001000,
  83     Processor14 = 0x00002000,
  84     Processor15 = 0x00004000,
  85     Processor16 = 0x00008000,
  86     Processor17 = 0x00010000,
  87     Processor18 = 0x00020000,
  88     Processor19 = 0x00040000,
  89     Processor20 = 0x00080000,
  90     Processor21 = 0x00100000,
  91     Processor22 = 0x00200000,
  92     Processor23 = 0x00400000,
  93     Processor24 = 0x00800000,
  94     Processor25 = 0x01000000,
  95     Processor26 = 0x02000000,
  96     Processor27 = 0x04000000,
  97     Processor28 = 0x08000000,
  98     Processor29 = 0x10000000,
  99     Processor30 = 0x20000000,
 100     Processor31 = 0x40000000,
 101     Processor32 = 0x80000000,
 102     XAUDIO2_ANY_PROCESSOR = 0xffffffff,
 103     XAUDIO2_DEFAULT_PROCESSOR = XAUDIO2_ANY_PROCESSOR
 104 } XAUDIO2_WINDOWS_PROCESSOR_SPECIFIER, XAUDIO2_PROCESSOR;
 105
 106 typedef struct XAUDIO2_PERFORMANCE_DATA
 107 {
 108     UINT64 AudioCyclesSinceLastQuery;
 109     UINT64 TotalCyclesSinceLastQuery;
 110     UINT32 MinimumCyclesPerQuantum;
 111     UINT32 MaximumCyclesPerQuantum;
 112     UINT32 MemoryUsageInBytes;
 113     UINT32 CurrentLatencyInSamples;
 114     UINT32 GlitchesSinceEngineStarted;
 115     UINT32 ActiveSourceVoiceCount;
 116     UINT32 TotalSourceVoiceCount;
 117     UINT32 ActiveSubmixVoiceCount;
 118     UINT32 ActiveResamplerCount;
 119     UINT32 ActiveMatrixMixCount;
 120     UINT32 ActiveXmaSourceVoices;
 121     UINT32 ActiveXmaStreams;
 122 } XAUDIO2_PERFORMANCE_DATA;
 123
 124 typedef enum XAUDIO2_DEVICE_ROLE
 125 {
 126     NotDefaultDevice            = 0x0,
 127     DefaultConsoleDevice        = 0x1,
 128     DefaultMultimediaDevice     = 0x2,
 129     DefaultCommunicationsDevice = 0x4,
 130     DefaultGameDevice           = 0x8,
 131     GlobalDefaultDevice         = 0xf,
 132     InvalidDeviceRole = ~GlobalDefaultDevice
 133 } XAUDIO2_DEVICE_ROLE;
 134
 135 typedef struct XAUDIO2_DEVICE_DETAILS
 136 {
 137     WCHAR DeviceID[256];
 138     WCHAR DisplayName[256];
 139     XAUDIO2_DEVICE_ROLE Role;
 140     WAVEFORMATEXTENSIBLE OutputFormat;
 141 } XAUDIO2_DEVICE_DETAILS;
 142
 143 typedef struct XAUDIO2_VOICE_DETAILS
 144 {
 145     UINT32 CreationFlags;
 146     UINT32 InputChannels;
 147     UINT32 InputSampleRate;
 148 } XAUDIO2_VOICE_DETAILS;
 149
 150 typedef struct XAUDIO2_SEND_DESCRIPTOR
 151 {
 152     UINT32 Flags;
 153     IXAudio2Voice* pOutputVoice;
 154 } XAUDIO2_SEND_DESCRIPTOR;
 155
 156 typedef struct XAUDIO2_VOICE_SENDS
 157 {
 158     UINT32 SendCount;
 159     XAUDIO2_SEND_DESCRIPTOR* pSends;
 160 } XAUDIO2_VOICE_SENDS;
 161
 162 typedef struct XAUDIO2_EFFECT_DESCRIPTOR
 163 {
 164     IUnknown* pEffect;
 165     BOOL InitialState;
 166     UINT32 OutputChannels;
 167 } XAUDIO2_EFFECT_DESCRIPTOR;
 168
 169 typedef struct XAUDIO2_EFFECT_CHAIN
 170 {
 171     UINT32 EffectCount;
 172     XAUDIO2_EFFECT_DESCRIPTOR* pEffectDescriptors;
 173 } XAUDIO2_EFFECT_CHAIN;
 174
 175 const UINT32 XAUDIO2_MAX_BUFFER_BYTES = 0x80000000;
 176 const UINT32 XAUDIO2_MAX_QUEUED_BUFFERS = 64;
 177 const UINT32 XAUDIO2_MAX_BUFFERS_SYSTEM = 2;
 178 const UINT32 XAUDIO2_MAX_AUDIO_CHANNELS = 64;
 179 const UINT32 XAUDIO2_MIN_SAMPLE_RATE = 1000;
 180 const UINT32 XAUDIO2_MAX_SAMPLE_RATE = 200000;
 181 const float XAUDIO2_MAX_VOLUME_LEVEL = 16777216.0;
 182 const float XAUDIO2_MIN_FREQ_RATIO = (1/1024.0);
 183 const float XAUDIO2_MAX_FREQ_RATIO = 1024.0;
 184 const float XAUDIO2_DEFAULT_FREQ_RATIO = 2.0;
 185 const float XAUDIO2_MAX_FILTER_ONEOVERQ = 1.5;
 186 const float XAUDIO2_MAX_FILTER_FREQUENCY = 1.0;
 187 const UINT32 XAUDIO2_MAX_LOOP_COUNT = 254;
 188
 189 const UINT32 XAUDIO2_COMMIT_NOW = 0;
 190 const UINT32 XAUDIO2_COMMIT_ALL = 0;
 191 const UINT32 XAUDIO2_INVALID_OPSET = 0xffffffff;
 192 const UINT32 XAUDIO2_NO_LOOP_REGION = 0;
 193 const UINT32 XAUDIO2_LOOP_INFINITE = 255;
 194 const UINT32 XAUDIO2_DEFAULT_CHANNELS = 0;
 195 const UINT32 XAUDIO2_DEFAULT_SAMPLERATE = 0;
 196
 197 [
 198     object,
 199     local
 200 ]
 201 interface IXAudio2EngineCallback
 202 {
 203     void OnProcessingPassStart();
 204
 205     void OnProcessingPassEnd();
 206
 207     void OnCriticalError([in] HRESULT Error);
 208 }
 209
 210 typedef enum XAUDIO2_FILTER_TYPE
 211 {
 212     LowPassFilter,
 213     BandPassFilter,
 214     HighPassFilter,
 215     NotchFilter
 216 } XAUDIO2_FILTER_TYPE;
 217
 218 typedef struct XAUDIO2_FILTER_PARAMETERS
 219 {
 220     XAUDIO2_FILTER_TYPE Type;
 221     float Frequency;
 222     float OneOverQ;
 223 } XAUDIO2_FILTER_PARAMETERS;
 224
 225 [
 226     object,
 227     local
 228 ]
 229 interface IXAudio2Voice
 230 {
 231     void GetVoiceDetails([out] XAUDIO2_VOICE_DETAILS* pVoiceDetails);
 232
 233     HRESULT SetOutputVoices([in] const XAUDIO2_VOICE_SENDS* pSendList);
 234
 235     HRESULT SetEffectChain([in] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 236
 237     HRESULT EnableEffect(
 238         [in] UINT32 EffectIndex,
 239         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 240
 241     HRESULT DisableEffect(
 242         [in] UINT32 EffectIndex,
 243         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 244
 245     void GetEffectState(
 246         [in] UINT32 EffectIndex,
 247         [out] BOOL* pEnabled);
 248
 249     HRESULT SetEffectParameters(
 250         [in] UINT32 EffectIndex,
 251         [in] const void* pParameters,
 252         [in] UINT32 ParametersByteSize,
 253         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 254
 255     HRESULT GetEffectParameters(
 256         [in] UINT32 EffectIndex,
 257         [out] void* pParameters,
 258         [in] UINT32 ParametersByteSize);
 259
 260     HRESULT SetFilterParameters(
 261         [in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
 262         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 263
 264     void GetFilterParameters([out] XAUDIO2_FILTER_PARAMETERS* pParameters);
 265
 266     HRESULT SetOutputFilterParameters(
 267         [in] IXAudio2Voice* pDestinationVoice,
 268         [in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
 269         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 270
 271     void GetOutputFilterParameters(
 272         [in] IXAudio2Voice* pDestinationVoice,
 273         [out] XAUDIO2_FILTER_PARAMETERS* pParameters);
 274
 275     HRESULT SetVolume(
 276         [in] float Volume,
 277         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 278
 279     void GetVolume([out] float* pVolume);
 280
 281     HRESULT SetChannelVolumes(
 282         [in] UINT32 Channels,
 283         [in, size_is(Channels)] const float* pVolumes,
 284         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 285
 286     void GetChannelVolumes(
 287         [in] UINT32 Channels,
 288         [out, size_is(Channels)] float* pVolumes);
 289
 290     HRESULT SetOutputMatrix(
 291         [in] IXAudio2Voice* pDestinationVoice,
 292         [in] UINT32 SourceChannels,
 293         [in] UINT32 DestinationChannels,
 294         [in, size_is(SourceChannels * DestinationChannels)] const float* pLevelMatrix,
 295         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 296
 297     void GetOutputMatrix(
 298         [in] IXAudio2Voice* pDestinationVoice,
 299         [in] UINT32 SourceChannels,
 300         [in] UINT32 DestinationChannels,
 301         [out, size_is(SourceChannels * DestinationChannels)] float* pLevelMatrix);
 302
 303     void DestroyVoice();
 304 }
 305
 306 typedef struct XAUDIO2_BUFFER
 307 {
 308     UINT32 Flags;
 309     UINT32 AudioBytes;
 310     const BYTE* pAudioData;
 311     UINT32 PlayBegin;
 312     UINT32 PlayLength;
 313     UINT32 LoopBegin;
 314     UINT32 LoopLength;
 315     UINT32 LoopCount;
 316     void* pContext;
 317 } XAUDIO2_BUFFER;
 318
 319 typedef struct XAUDIO2_BUFFER_WMA
 320 {
 321     const UINT32* pDecodedPacketCumulativeBytes;
 322     UINT32 PacketCount;
 323 } XAUDIO2_BUFFER_WMA;
 324
 325 typedef struct XAUDIO2_VOICE_STATE
 326 {
 327     void* pCurrentBufferContext;
 328     UINT32 BuffersQueued;
 329     UINT64 SamplesPlayed;
 330 } XAUDIO2_VOICE_STATE;
 331
 332 [
 333     local
 334 ]
 335 /* XAudio2 2.7's IXAudio2SourceVoice interface. Actually called
 336  * IXAudio2SourceVoice in the Jun 2010 DX SDK */
 337 interface IXAudio27SourceVoice : IXAudio2Voice
 338 {
 339     HRESULT Start(
 340         [in, defaultvalue(0)] UINT32 Flags,
 341         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 342
 343     HRESULT Stop(
 344         [in, defaultvalue(0)] UINT32 Flags,
 345         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 346
 347     HRESULT SubmitSourceBuffer(
 348         [in] const XAUDIO2_BUFFER* pBuffer,
 349         [in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
 350
 351     HRESULT FlushSourceBuffers();
 352
 353     HRESULT Discontinuity();
 354
 355     HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 356
 357     void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState);
 358
 359     HRESULT SetFrequencyRatio(
 360         [in] float Ratio,
 361         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 362
 363     void GetFrequencyRatio([out] float* pRatio);
 364
 365     HRESULT SetSourceSampleRate([in] UINT32 NewSourceSampleRate);
 366 }
 367
 368 [
 369     local
 370 ]
 371 /* XAudio2 2.8's IXAudio2SourceVoice interface. */
 372 interface IXAudio2SourceVoice : IXAudio2Voice
 373 {
 374     HRESULT Start(
 375         [in, defaultvalue(0)] UINT32 Flags,
 376         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 377
 378     HRESULT Stop(
 379         [in, defaultvalue(0)] UINT32 Flags,
 380         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 381
 382     HRESULT SubmitSourceBuffer(
 383         [in] const XAUDIO2_BUFFER* pBuffer,
 384         [in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
 385
 386     HRESULT FlushSourceBuffers();
 387
 388     HRESULT Discontinuity();
 389
 390     HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 391
 392     void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState, [in, defaultvalue(0)] UINT32 Flags);
 393
 394     HRESULT SetFrequencyRatio(
 395         [in] float Ratio,
 396         [in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
 397
 398     void GetFrequencyRatio([out] float* pRatio);
 399
 400     HRESULT SetSourceSampleRate([in] UINT32 NewSourceSampleRate);
 401 }
 402
 403 [
 404     local
 405 ]
 406 interface IXAudio2SubmixVoice : IXAudio2Voice
 407 {
 408 }
 409
 410 [
 411     local
 412 ]
 413 interface IXAudio2MasteringVoice : IXAudio2Voice
 414 {
 415     /* not present in XAudio2 2.7 */
 416     void GetChannelMask([out] DWORD *pChannelMask);
 417 }
 418
 419 [
 420     object,
 421     local
 422 ]
 423 interface IXAudio2VoiceCallback
 424 {
 425     void OnVoiceProcessingPassStart([in] UINT32 BytesRequired);
 426
 427     void OnVoiceProcessingPassEnd();
 428
 429     void OnStreamEnd();
 430
 431     void OnBufferStart([in] void* pBufferContext);
 432
 433     void OnBufferEnd([in] void* pBufferContext);
 434
 435     void OnLoopEnd([in] void* pBufferContext);
 436
 437     void OnVoiceError(
 438         [in] void* pBuffercontext,
 439         [in] HRESULT Error);
 440 }
 441
 442 typedef struct XAUDIO2_DEBUG_CONFIGURATION
 443 {
 444     UINT32 TraceMask;
 445     UINT32 BreakMask;
 446     BOOL LogThreadID;
 447     BOOL LogFileline;
 448     BOOL LogFunctionName;
 449     BOOL LogTiming;
 450 } XAUDIO2_DEBUG_CONFIGURATION;
 451
 452 [
 453     object,
 454     uuid(8bcf1f58-9fe7-4583-8ac6-e2adc465c8bb),
 455 ]
 456 /* XAudio2 2.7's IXAudio2 interface. Actually called IXAudio2 in the Jun 2010
 457  * DX SDK */
 458 interface IXAudio27 : IUnknown
 459 {
 460     HRESULT GetDeviceCount([out] UINT32* pCount);
 461
 462     HRESULT GetDeviceDetails(
 463         [in] UINT32 Index,
 464         [out] XAUDIO2_DEVICE_DETAILS* pDeviceDetails);
 465
 466     HRESULT Initialize(
 467         [in, defaultvalue(0)] UINT32 Flags,
 468         [in, defaultvalue(XAUDIO2_DEFAULT_PROCESSOR)] XAUDIO2_PROCESSOR XAudio2Processor);
 469
 470     HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
 471
 472     void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
 473
 474     HRESULT CreateSourceVoice(
 475         [out] IXAudio2SourceVoice** ppSourceVoice,
 476         [in] const WAVEFORMATEX* pSourceFormat,
 477         [in, defaultvalue(0)] UINT32 Flags,
 478         [in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
 479         [in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
 480         [in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
 481         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 482
 483     HRESULT CreateSubmixVoice(
 484         [out] IXAudio2SubmixVoice** ppSubmixVoice,
 485         [in] UINT32 InputChannels,
 486         [in] UINT32 InputSampleRate,
 487         [in, defaultvalue(0)] UINT32 Flags,
 488         [in, defaultvalue(0)] UINT32 ProcessingStage,
 489         [in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
 490         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 491
 492     HRESULT CreateMasteringVoice(
 493         [out] IXAudio2MasteringVoice** ppMasteringVoice,
 494         [in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
 495         [in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
 496         [in, defaultvalue(0)] UINT32 Flags,
 497         [in, defaultvalue(0)] UINT32 DeviceIndex,
 498         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 499
 500     HRESULT StartEngine();
 501
 502     void StopEngine();
 503
 504     HRESULT CommitChanges([in] UINT32 OperationSet);
 505
 506     void GetPerformanceData([out] XAUDIO2_PERFORMANCE_DATA* pPerfData);
 507
 508     [local] void SetDebugConfiguration(
 509         [in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
 510         [in, defaultvalue(NULL)] void* pReserved);
 511 }
 512
 513 [
 514     object,
 515     uuid(60d8dac8-5aa1-4e8e-b597-2f5e2883d484),
 516 ]
 517 /* XAudio2 2.8's IXAudio2 interface. */
 518 interface IXAudio2 : IUnknown
 519 {
 520     HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
 521
 522     void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
 523
 524     HRESULT CreateSourceVoice(
 525         [out] IXAudio2SourceVoice** ppSourceVoice,
 526         [in] const WAVEFORMATEX* pSourceFormat,
 527         [in, defaultvalue(0)] UINT32 Flags,
 528         [in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
 529         [in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
 530         [in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
 531         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 532
 533     HRESULT CreateSubmixVoice(
 534         [out] IXAudio2SubmixVoice** ppSubmixVoice,
 535         [in] UINT32 InputChannels,
 536         [in] UINT32 InputSampleRate,
 537         [in, defaultvalue(0)] UINT32 Flags,
 538         [in, defaultvalue(0)] UINT32 ProcessingStage,
 539         [in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
 540         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
 541
 542     HRESULT CreateMasteringVoice(
 543         [out] IXAudio2MasteringVoice** ppMasteringVoice,
 544         [in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
 545         [in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
 546         [in, defaultvalue(0)] UINT32 Flags,
 547         [in, defaultvalue(NULL)] LPCWSTR DeviceId,
 548         [in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain,
 549         [in, defaultvalue(AudioCategory_GameEffects)] AUDIO_STREAM_CATEGORY StreamCategory);
 550
 551     HRESULT StartEngine();
 552
 553     void StopEngine();
 554
 555     HRESULT CommitChanges([in] UINT32 OperationSet);
 556
 557     void GetPerformanceData([out] XAUDIO2_PERFORMANCE_DATA* pPerfData);
 558
 559     [local] void SetDebugConfiguration(
 560         [in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
 561         [in, defaultvalue(NULL)] void* pReserved);
 562 }
 563
 564 const UINT32 XAUDIO2_DEBUG_ENGINE = 1;
 565 const UINT32 XAUDIO2_VOICE_NOPITCH = 2;
 566 const UINT32 XAUDIO2_VOICE_NOSRC = 4;
 567 const UINT32 XAUDIO2_VOICE_USEFILTER = 8;
 568 const UINT32 XAUDIO2_VOICE_MUSIC = 16;
 569 const UINT32 XAUDIO2_PLAY_TAILS = 32;
 570 const UINT32 XAUDIO2_END_OF_STREAM = 64;
 571 const UINT32 XAUDIO2_SEND_USEFILTER = 128;
 572 const UINT32 XAUDIO2_VOICE_NOSAMPLESPLAYED = 256;
 573
 574 const XAUDIO2_FILTER_TYPE XAUDIO2_DEFAULT_FILTER_TYPE = LowPassFilter;
 575 const float XAUDIO2_DEFAULT_FILTER_FREQUENCY = XAUDIO2_MAX_FILTER_FREQUENCY;
 576 const float XAUDIO2_DEFAULT_FILTER_ONEOVERQ = 1.0;
 577 const UINT32 XAUDIO2_QUANTUM_NUMERATOR = 1;
 578 const UINT32 XAUDIO2_QUANTUM_DENOMINATOR = 100;
 579 const float XAUDIO2_QUANTUM_MS = (1000.0 * XAUDIO2_QUANTUM_NUMERATOR / XAUDIO2_QUANTUM_DENOMINATOR);
 580
 581 const HRESULT XAUDIO2_E_INVALID_CALL = 0x88960001;
 582 const HRESULT XAUDIO2_E_XMA_DECODER_ERROR = 0x88960002;
 583 const HRESULT XAUDIO2_E_XAPO_CREATION_FAILED = 0x88960003;
 584 const HRESULT XAUDIO2_E_DEVICE_INVALIDATED = 0x88960004;
 585
 586 cpp_quote("#ifdef XAUDIO2_HELPER_FUNCTIONS")
 587 cpp_quote("#define _USE_MATH_DEFINES")
 588 cpp_quote("#include <math.h>")
 589 cpp_quote("inline static float XAudio2DecibelsToAmplitudeRatio(float decibels) { return powf(10.0f, decibels/20.0f); }")
 590 cpp_quote("inline static float XAudio2AmplitudeRatioToDecibels(float volume) { if (volume == 0) { return -3.402823466e+38f; } return 20.0f * log10f(volume); }")
 591 cpp_quote("inline static float XAudio2SemitonesToFrequencyRatio(float semitones) { return powf(2.0f, semitones/12.0f); }")
 592 cpp_quote("inline static float XAudio2FrequencyRatioToSemitones(float freqratio) { return 39.86313713864835f * log10f(freqratio); }")
 593 cpp_quote("inline static float XAudio2CutoffFrequencyToRadians(float cutofffreq, UINT32 samplerate) { if ((UINT32)(cutofffreq * 6.0f) >= samplerate) { return XAUDIO2_MAX_FILTER_FREQUENCY; } return 2.0f * sinf((float)M_PI * cutofffreq / samplerate); }")
 594 cpp_quote("inline static float XAudio2RadiansToCutoffFrequency(float radians, float samplerate) { return samplerate * asinf(radians/2.0f) / (float)M_PI; }")
 595 cpp_quote("#endif")
 596
 597 cpp_quote("HRESULT WINAPI XAudio2Create(IXAudio2** pxaudio2, UINT32 flags, XAUDIO2_PROCESSOR processor);")
 598
 599 cpp_quote("#include <poppack.h>")