mirror of
git://source.winehq.org/git/wine.git
synced 2024-11-01 19:18:42 +00:00
3076d37af8
Signed-off-by: Biswapriyo Nath <nathbappai@gmail.com> Signed-off-by: Alexandre Julliard <julliard@winehq.org>
1270 lines
38 KiB
Text
1270 lines
38 KiB
Text
/*
|
|
* Copyright (c) 2015 Mark Harmstone
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
|
|
*/
|
|
|
|
import "unknwn.idl";
|
|
import "mmdeviceapi.idl";
|
|
|
|
import "audiosessiontypes.h";
|
|
|
|
cpp_quote("#include <pshpack1.h>")
|
|
|
|
[
|
|
uuid(fac23f48-31f5-45a8-b49b-5225d61401aa)
|
|
]
|
|
coclass XAudio20 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(e21a7345-eb21-468e-be50-804db97cf708)
|
|
]
|
|
coclass XAudio21 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(b802058a-464a-42db-bc10-b650d6f2586a)
|
|
]
|
|
coclass XAudio22 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(4c5e637a-16c7-4de3-9c46-5ed22181962d)
|
|
]
|
|
coclass XAudio23 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(03219e78-5bc3-44d1-b92e-f63d89cc6526)
|
|
]
|
|
coclass XAudio24 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(4c9b6dde-6809-46e6-a278-9b6a97588670)
|
|
]
|
|
coclass XAudio25 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(3eda9b49-2085-498b-9bb2-39a6778493de)
|
|
]
|
|
coclass XAudio26 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(5a508685-a254-4fba-9b82-9a24b00306af)
|
|
]
|
|
coclass XAudio27 {
|
|
interface IUnknown;
|
|
}
|
|
|
|
[
|
|
uuid(db05ea35-0329-4d4b-a53a-6dead03d3852)
|
|
]
|
|
coclass XAudio2Debug {
|
|
interface IUnknown;
|
|
}
|
|
|
|
cpp_quote("#if 0")
|
|
typedef struct WAVEFORMATEX
|
|
{
|
|
WORD wFormatTag;
|
|
WORD nChannels;
|
|
DWORD nSamplesPerSec;
|
|
DWORD nAvgBytesPerSec;
|
|
WORD nBlockAlign;
|
|
WORD wBitsPerSample;
|
|
WORD cbSize;
|
|
} WAVEFORMATEX;
|
|
|
|
typedef struct {
|
|
WAVEFORMATEX Format;
|
|
union {
|
|
WORD wValidBitsPerSample;
|
|
WORD wSamplesPerBlock;
|
|
WORD wReserved;
|
|
} Samples;
|
|
DWORD dwChannelMask;
|
|
GUID SubFormat;
|
|
} WAVEFORMATEXTENSIBLE, *PWAVEFORMATEXTENSIBLE;
|
|
cpp_quote("#else")
|
|
cpp_quote("#include <mmreg.h>")
|
|
cpp_quote("#endif")
|
|
|
|
interface IXAudio2Voice;
|
|
|
|
typedef enum XAUDIO2_WINDOWS_PROCESSOR_SPECIFIER
|
|
{
|
|
Processor1 = 0x00000001,
|
|
Processor2 = 0x00000002,
|
|
Processor3 = 0x00000004,
|
|
Processor4 = 0x00000008,
|
|
Processor5 = 0x00000010,
|
|
Processor6 = 0x00000020,
|
|
Processor7 = 0x00000040,
|
|
Processor8 = 0x00000080,
|
|
Processor9 = 0x00000100,
|
|
Processor10 = 0x00000200,
|
|
Processor11 = 0x00000400,
|
|
Processor12 = 0x00000800,
|
|
Processor13 = 0x00001000,
|
|
Processor14 = 0x00002000,
|
|
Processor15 = 0x00004000,
|
|
Processor16 = 0x00008000,
|
|
Processor17 = 0x00010000,
|
|
Processor18 = 0x00020000,
|
|
Processor19 = 0x00040000,
|
|
Processor20 = 0x00080000,
|
|
Processor21 = 0x00100000,
|
|
Processor22 = 0x00200000,
|
|
Processor23 = 0x00400000,
|
|
Processor24 = 0x00800000,
|
|
Processor25 = 0x01000000,
|
|
Processor26 = 0x02000000,
|
|
Processor27 = 0x04000000,
|
|
Processor28 = 0x08000000,
|
|
Processor29 = 0x10000000,
|
|
Processor30 = 0x20000000,
|
|
Processor31 = 0x40000000,
|
|
Processor32 = 0x80000000,
|
|
XAUDIO2_ANY_PROCESSOR = 0xffffffff,
|
|
XAUDIO2_DEFAULT_PROCESSOR = XAUDIO2_ANY_PROCESSOR
|
|
} XAUDIO2_WINDOWS_PROCESSOR_SPECIFIER, XAUDIO2_PROCESSOR;
|
|
|
|
typedef struct XAUDIO2_PERFORMANCE_DATA
|
|
{
|
|
UINT64 AudioCyclesSinceLastQuery;
|
|
UINT64 TotalCyclesSinceLastQuery;
|
|
UINT32 MinimumCyclesPerQuantum;
|
|
UINT32 MaximumCyclesPerQuantum;
|
|
UINT32 MemoryUsageInBytes;
|
|
UINT32 CurrentLatencyInSamples;
|
|
UINT32 GlitchesSinceEngineStarted;
|
|
UINT32 ActiveSourceVoiceCount;
|
|
UINT32 TotalSourceVoiceCount;
|
|
UINT32 ActiveSubmixVoiceCount;
|
|
UINT32 ActiveResamplerCount;
|
|
UINT32 ActiveMatrixMixCount;
|
|
UINT32 ActiveXmaSourceVoices;
|
|
UINT32 ActiveXmaStreams;
|
|
} XAUDIO2_PERFORMANCE_DATA;
|
|
|
|
typedef struct XAUDIO22_PERFORMANCE_DATA
|
|
{
|
|
UINT64 AudioCyclesSinceLastQuery;
|
|
UINT64 TotalCyclesSinceLastQuery;
|
|
UINT32 MinimumCyclesPerQuantum;
|
|
UINT32 MaximumCyclesPerQuantum;
|
|
UINT32 MemoryUsageInBytes;
|
|
UINT32 CurrentLatencyInSamples;
|
|
UINT32 GlitchesSinceEngineStarted;
|
|
UINT32 ActiveSourceVoiceCount;
|
|
UINT32 TotalSourceVoiceCount;
|
|
UINT32 ActiveSubmixVoiceCount;
|
|
UINT32 TotalSubmixVoiceCount;
|
|
UINT32 ActiveXmaSourceVoices;
|
|
UINT32 ActiveXmaStreams;
|
|
} XAUDIO22_PERFORMANCE_DATA;
|
|
|
|
typedef struct XAUDIO20_PERFORMANCE_DATA
|
|
{
|
|
UINT64 AudioCyclesSinceLastQuery;
|
|
UINT64 TotalCyclesSinceLastQuery;
|
|
UINT32 MinimumCyclesPerQuantum;
|
|
UINT32 MaximumCyclesPerQuantum;
|
|
UINT32 MemoryUsageInBytes;
|
|
UINT32 CurrentLatencyInSamples;
|
|
UINT32 GlitchesSinceLastQuery;
|
|
UINT32 ActiveSourceVoiceCount;
|
|
UINT32 TotalSourceVoiceCount;
|
|
UINT32 ActiveSubmixVoiceCount;
|
|
UINT32 TotalSubmixVoiceCount;
|
|
UINT32 ActiveXmaSourceVoices;
|
|
UINT32 ActiveXmaStreams;
|
|
} XAUDIO20_PERFORMANCE_DATA;
|
|
|
|
typedef enum XAUDIO2_DEVICE_ROLE
|
|
{
|
|
NotDefaultDevice = 0x0,
|
|
DefaultConsoleDevice = 0x1,
|
|
DefaultMultimediaDevice = 0x2,
|
|
DefaultCommunicationsDevice = 0x4,
|
|
DefaultGameDevice = 0x8,
|
|
GlobalDefaultDevice = 0xf,
|
|
InvalidDeviceRole = ~GlobalDefaultDevice
|
|
} XAUDIO2_DEVICE_ROLE;
|
|
|
|
typedef struct XAUDIO2_DEVICE_DETAILS
|
|
{
|
|
WCHAR DeviceID[256];
|
|
WCHAR DisplayName[256];
|
|
XAUDIO2_DEVICE_ROLE Role;
|
|
WAVEFORMATEXTENSIBLE OutputFormat;
|
|
} XAUDIO2_DEVICE_DETAILS;
|
|
|
|
typedef struct XAUDIO27_VOICE_DETAILS
|
|
{
|
|
UINT32 CreationFlags;
|
|
UINT32 InputChannels;
|
|
UINT32 InputSampleRate;
|
|
} XAUDIO27_VOICE_DETAILS;
|
|
|
|
typedef struct XAUDIO2_VOICE_DETAILS
|
|
{
|
|
UINT32 CreationFlags;
|
|
UINT32 ActiveFlags;
|
|
UINT32 InputChannels;
|
|
UINT32 InputSampleRate;
|
|
} XAUDIO2_VOICE_DETAILS;
|
|
|
|
typedef struct XAUDIO2_SEND_DESCRIPTOR
|
|
{
|
|
UINT32 Flags;
|
|
IXAudio2Voice* pOutputVoice;
|
|
} XAUDIO2_SEND_DESCRIPTOR;
|
|
|
|
/* XAudio2 2.3's XAUDIO2_VOICE_SENDS struct */
|
|
typedef struct XAUDIO23_VOICE_SENDS
|
|
{
|
|
UINT32 OutputCount;
|
|
IXAudio2Voice **pOutputVoices;
|
|
} XAUDIO23_VOICE_SENDS;
|
|
|
|
typedef struct XAUDIO2_VOICE_SENDS
|
|
{
|
|
UINT32 SendCount;
|
|
XAUDIO2_SEND_DESCRIPTOR* pSends;
|
|
} XAUDIO2_VOICE_SENDS;
|
|
|
|
typedef struct XAUDIO2_EFFECT_DESCRIPTOR
|
|
{
|
|
IUnknown* pEffect;
|
|
BOOL InitialState;
|
|
UINT32 OutputChannels;
|
|
} XAUDIO2_EFFECT_DESCRIPTOR;
|
|
|
|
typedef struct XAUDIO2_EFFECT_CHAIN
|
|
{
|
|
UINT32 EffectCount;
|
|
XAUDIO2_EFFECT_DESCRIPTOR* pEffectDescriptors;
|
|
} XAUDIO2_EFFECT_CHAIN;
|
|
|
|
const UINT32 XAUDIO2_MAX_BUFFER_BYTES = 0x80000000;
|
|
const UINT32 XAUDIO2_MAX_QUEUED_BUFFERS = 64;
|
|
const UINT32 XAUDIO2_MAX_BUFFERS_SYSTEM = 2;
|
|
const UINT32 XAUDIO2_MAX_AUDIO_CHANNELS = 64;
|
|
const UINT32 XAUDIO2_MIN_SAMPLE_RATE = 1000;
|
|
const UINT32 XAUDIO2_MAX_SAMPLE_RATE = 200000;
|
|
const float XAUDIO2_MAX_VOLUME_LEVEL = 16777216.0;
|
|
const float XAUDIO2_MIN_FREQ_RATIO = (1/1024.0);
|
|
const float XAUDIO2_MAX_FREQ_RATIO = 1024.0;
|
|
const float XAUDIO2_DEFAULT_FREQ_RATIO = 2.0;
|
|
const float XAUDIO2_MAX_FILTER_ONEOVERQ = 1.5;
|
|
const float XAUDIO2_MAX_FILTER_FREQUENCY = 1.0;
|
|
const UINT32 XAUDIO2_MAX_LOOP_COUNT = 254;
|
|
const UINT32 XAUDIO20_MAX_LOOP_COUNT = 0x100000; /* xaudio 2.0 */
|
|
|
|
const UINT32 XAUDIO2_COMMIT_NOW = 0;
|
|
const UINT32 XAUDIO2_COMMIT_ALL = 0;
|
|
const UINT32 XAUDIO2_INVALID_OPSET = 0xffffffff;
|
|
const UINT32 XAUDIO2_NO_LOOP_REGION = 0;
|
|
const UINT32 XAUDIO2_LOOP_INFINITE = 255;
|
|
const UINT32 XAUDIO20_LOOP_INFINITE = ((UINT)-1); /* xaudio 2.0 */
|
|
const UINT32 XAUDIO2_DEFAULT_CHANNELS = 0;
|
|
const UINT32 XAUDIO2_DEFAULT_SAMPLERATE = 0;
|
|
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio2EngineCallback
|
|
{
|
|
void OnProcessingPassStart();
|
|
|
|
void OnProcessingPassEnd();
|
|
|
|
void OnCriticalError([in] HRESULT Error);
|
|
}
|
|
|
|
typedef enum XAUDIO2_FILTER_TYPE
|
|
{
|
|
LowPassFilter,
|
|
BandPassFilter,
|
|
HighPassFilter,
|
|
NotchFilter
|
|
} XAUDIO2_FILTER_TYPE;
|
|
|
|
typedef struct XAUDIO2_FILTER_PARAMETERS
|
|
{
|
|
XAUDIO2_FILTER_TYPE Type;
|
|
float Frequency;
|
|
float OneOverQ;
|
|
} XAUDIO2_FILTER_PARAMETERS;
|
|
|
|
/* XAudio 2.0's IXAudio2Voice */
|
|
/* XAudio2 2.0's IXAudio2Voice interface. Actually called
|
|
* IXAudio2Voice in the Mar 2008 DX SDK */
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio20Voice
|
|
{
|
|
void GetVoiceDetails([out] XAUDIO27_VOICE_DETAILS* pVoiceDetails);
|
|
|
|
HRESULT SetOutputVoices([in] const XAUDIO23_VOICE_SENDS* pSendList);
|
|
|
|
HRESULT SetEffectChain([in] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT EnableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT DisableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetEffectState(
|
|
[in] UINT32 EffectIndex,
|
|
[out] BOOL* pEnabled);
|
|
|
|
HRESULT SetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[in] const void* pParameters,
|
|
[in] UINT32 ParametersByteSize,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT GetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[out] void* pParameters,
|
|
[in] UINT32 ParametersByteSize);
|
|
|
|
HRESULT SetFilterParameters(
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFilterParameters([out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetVolume(
|
|
[in] float Volume,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetVolume([out] float* pVolume);
|
|
|
|
HRESULT SetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[in, size_is(Channels)] const float* pVolumes,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[out, size_is(Channels)] float* pVolumes);
|
|
|
|
HRESULT SetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[in, size_is(SourceChannels * DestinationChannels)] const float* pLevelMatrix,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT GetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[out, size_is(SourceChannels * DestinationChannels)] float* pLevelMatrix);
|
|
|
|
void DestroyVoice();
|
|
}
|
|
|
|
/* XAudio 2.3's IXAudio2Voice */
|
|
/* XAudio2 2.3's IXAudio2Voice interface. Actually called
|
|
* IXAudio2Voice in the Nov 2008 DX SDK */
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio23Voice
|
|
{
|
|
void GetVoiceDetails([out] XAUDIO27_VOICE_DETAILS* pVoiceDetails);
|
|
|
|
HRESULT SetOutputVoices([in] const XAUDIO23_VOICE_SENDS* pSendList);
|
|
|
|
HRESULT SetEffectChain([in] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT EnableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT DisableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetEffectState(
|
|
[in] UINT32 EffectIndex,
|
|
[out] BOOL* pEnabled);
|
|
|
|
HRESULT SetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[in] const void* pParameters,
|
|
[in] UINT32 ParametersByteSize,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT GetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[out] void* pParameters,
|
|
[in] UINT32 ParametersByteSize);
|
|
|
|
HRESULT SetFilterParameters(
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFilterParameters([out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetVolume(
|
|
[in] float Volume,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetVolume([out] float* pVolume);
|
|
|
|
HRESULT SetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[in, size_is(Channels)] const float* pVolumes,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[out, size_is(Channels)] float* pVolumes);
|
|
|
|
HRESULT SetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[in, size_is(SourceChannels * DestinationChannels)] const float* pLevelMatrix,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[out, size_is(SourceChannels * DestinationChannels)] float* pLevelMatrix);
|
|
|
|
void DestroyVoice();
|
|
}
|
|
|
|
/* XAudio 2.7's IXAudio2Voice */
|
|
/* XAudio2 2.7's IXAudio2Voice interface. Actually called
|
|
* IXAudio2Voice in the Jun 2010 DX SDK */
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio27Voice
|
|
{
|
|
void GetVoiceDetails([out] XAUDIO27_VOICE_DETAILS* pVoiceDetails);
|
|
|
|
HRESULT SetOutputVoices([in] const XAUDIO2_VOICE_SENDS* pSendList);
|
|
|
|
HRESULT SetEffectChain([in] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT EnableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT DisableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetEffectState(
|
|
[in] UINT32 EffectIndex,
|
|
[out] BOOL* pEnabled);
|
|
|
|
HRESULT SetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[in] const void* pParameters,
|
|
[in] UINT32 ParametersByteSize,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT GetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[out] void* pParameters,
|
|
[in] UINT32 ParametersByteSize);
|
|
|
|
HRESULT SetFilterParameters(
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFilterParameters([out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetOutputFilterParameters(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetOutputFilterParameters(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetVolume(
|
|
[in] float Volume,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetVolume([out] float* pVolume);
|
|
|
|
HRESULT SetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[in, size_is(Channels)] const float* pVolumes,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[out, size_is(Channels)] float* pVolumes);
|
|
|
|
HRESULT SetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[in, size_is(SourceChannels * DestinationChannels)] const float* pLevelMatrix,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[out, size_is(SourceChannels * DestinationChannels)] float* pLevelMatrix);
|
|
|
|
void DestroyVoice();
|
|
}
|
|
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio2Voice
|
|
{
|
|
void GetVoiceDetails([out] XAUDIO2_VOICE_DETAILS* pVoiceDetails);
|
|
|
|
HRESULT SetOutputVoices([in] const XAUDIO2_VOICE_SENDS* pSendList);
|
|
|
|
HRESULT SetEffectChain([in] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT EnableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT DisableEffect(
|
|
[in] UINT32 EffectIndex,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetEffectState(
|
|
[in] UINT32 EffectIndex,
|
|
[out] BOOL* pEnabled);
|
|
|
|
HRESULT SetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[in] const void* pParameters,
|
|
[in] UINT32 ParametersByteSize,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT GetEffectParameters(
|
|
[in] UINT32 EffectIndex,
|
|
[out] void* pParameters,
|
|
[in] UINT32 ParametersByteSize);
|
|
|
|
HRESULT SetFilterParameters(
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFilterParameters([out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetOutputFilterParameters(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] const XAUDIO2_FILTER_PARAMETERS* pParameters,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetOutputFilterParameters(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[out] XAUDIO2_FILTER_PARAMETERS* pParameters);
|
|
|
|
HRESULT SetVolume(
|
|
[in] float Volume,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetVolume([out] float* pVolume);
|
|
|
|
HRESULT SetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[in, size_is(Channels)] const float* pVolumes,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetChannelVolumes(
|
|
[in] UINT32 Channels,
|
|
[out, size_is(Channels)] float* pVolumes);
|
|
|
|
HRESULT SetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[in, size_is(SourceChannels * DestinationChannels)] const float* pLevelMatrix,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetOutputMatrix(
|
|
[in] IXAudio2Voice* pDestinationVoice,
|
|
[in] UINT32 SourceChannels,
|
|
[in] UINT32 DestinationChannels,
|
|
[out, size_is(SourceChannels * DestinationChannels)] float* pLevelMatrix);
|
|
|
|
void DestroyVoice();
|
|
}
|
|
|
|
typedef struct XAUDIO2_BUFFER
|
|
{
|
|
UINT32 Flags;
|
|
UINT32 AudioBytes;
|
|
const BYTE* pAudioData;
|
|
UINT32 PlayBegin;
|
|
UINT32 PlayLength;
|
|
UINT32 LoopBegin;
|
|
UINT32 LoopLength;
|
|
UINT32 LoopCount;
|
|
void* pContext;
|
|
} XAUDIO2_BUFFER;
|
|
|
|
typedef struct XAUDIO2_BUFFER_WMA
|
|
{
|
|
const UINT32* pDecodedPacketCumulativeBytes;
|
|
UINT32 PacketCount;
|
|
} XAUDIO2_BUFFER_WMA;
|
|
|
|
typedef struct XAUDIO2_VOICE_STATE
|
|
{
|
|
void* pCurrentBufferContext;
|
|
UINT32 BuffersQueued;
|
|
UINT64 SamplesPlayed;
|
|
} XAUDIO2_VOICE_STATE;
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.0's IXAudio2SourceVoice interface. Actually called
|
|
* IXAudio2SourceVoice in the Mar 2008 DX SDK */
|
|
interface IXAudio20SourceVoice : IXAudio20Voice
|
|
{
|
|
HRESULT Start(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT Stop(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT SubmitSourceBuffer(
|
|
[in] const XAUDIO2_BUFFER* pBuffer,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
|
|
|
|
HRESULT FlushSourceBuffers();
|
|
|
|
HRESULT Discontinuity();
|
|
|
|
HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState);
|
|
|
|
HRESULT SetFrequencyRatio(
|
|
[in] float Ratio,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFrequencyRatio([out] float* pRatio);
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.3's IXAudio2SourceVoice interface. Actually called
|
|
* IXAudio2SourceVoice in the Nov 2008 DX SDK */
|
|
interface IXAudio23SourceVoice : IXAudio23Voice
|
|
{
|
|
HRESULT Start(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT Stop(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT SubmitSourceBuffer(
|
|
[in] const XAUDIO2_BUFFER* pBuffer,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
|
|
|
|
HRESULT FlushSourceBuffers();
|
|
|
|
HRESULT Discontinuity();
|
|
|
|
HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState);
|
|
|
|
HRESULT SetFrequencyRatio(
|
|
[in] float Ratio,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFrequencyRatio([out] float* pRatio);
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.7's IXAudio2SourceVoice interface. Actually called
|
|
* IXAudio2SourceVoice in the Jun 2010 DX SDK */
|
|
interface IXAudio27SourceVoice : IXAudio27Voice
|
|
{
|
|
HRESULT Start(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT Stop(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT SubmitSourceBuffer(
|
|
[in] const XAUDIO2_BUFFER* pBuffer,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
|
|
|
|
HRESULT FlushSourceBuffers();
|
|
|
|
HRESULT Discontinuity();
|
|
|
|
HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState);
|
|
|
|
HRESULT SetFrequencyRatio(
|
|
[in] float Ratio,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFrequencyRatio([out] float* pRatio);
|
|
|
|
HRESULT SetSourceSampleRate([in] UINT32 NewSourceSampleRate);
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.8's IXAudio2SourceVoice interface. */
|
|
interface IXAudio2SourceVoice : IXAudio2Voice
|
|
{
|
|
HRESULT Start(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT Stop(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
HRESULT SubmitSourceBuffer(
|
|
[in] const XAUDIO2_BUFFER* pBuffer,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_BUFFER_WMA* pBufferWMA);
|
|
|
|
HRESULT FlushSourceBuffers();
|
|
|
|
HRESULT Discontinuity();
|
|
|
|
HRESULT ExitLoop([in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetState([out] XAUDIO2_VOICE_STATE* pVoiceState, [in, defaultvalue(0)] UINT32 Flags);
|
|
|
|
HRESULT SetFrequencyRatio(
|
|
[in] float Ratio,
|
|
[in, defaultvalue(XAUDIO2_COMMIT_NOW)] UINT32 OperationSet);
|
|
|
|
void GetFrequencyRatio([out] float* pRatio);
|
|
|
|
HRESULT SetSourceSampleRate([in] UINT32 NewSourceSampleRate);
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.0's IXAudio2SubmixVoice interface. Actually called
|
|
* IXAudio2SubmixVoice in the Mar 2008 DX SDK */
|
|
interface IXAudio20SubmixVoice : IXAudio20Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.3's IXAudio2SubmixVoice interface. Actually called
|
|
* IXAudio2SubmixVoice in the Nov 2008 DX SDK */
|
|
interface IXAudio23SubmixVoice : IXAudio23Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.7's IXAudio2SubmixVoice interface. Actually called
|
|
* IXAudio2SubmixVoice in the Jun 2010 DX SDK */
|
|
interface IXAudio27SubmixVoice : IXAudio27Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
interface IXAudio2SubmixVoice : IXAudio2Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.0's IXAudio2MasteringVoice interface. Actually called
|
|
* IXAudio2MasteringVoice in the Mar 2008 DX SDK */
|
|
interface IXAudio20MasteringVoice : IXAudio20Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.3's IXAudio2MasteringVoice interface. Actually called
|
|
* IXAudio2MasteringVoice in the Nov 2008 DX SDK */
|
|
interface IXAudio23MasteringVoice : IXAudio23Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
/* XAudio2 2.7's IXAudio2MasteringVoice interface. Actually called
|
|
* IXAudio2MasteringVoice in the Jun 2010 DX SDK */
|
|
interface IXAudio27MasteringVoice : IXAudio27Voice
|
|
{
|
|
}
|
|
|
|
[
|
|
local
|
|
]
|
|
interface IXAudio2MasteringVoice : IXAudio2Voice
|
|
{
|
|
/* not present in XAudio2 2.7 */
|
|
void GetChannelMask([out] DWORD *pChannelMask);
|
|
}
|
|
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio20VoiceCallback
|
|
{
|
|
void OnVoiceProcessingPassStart();
|
|
|
|
void OnVoiceProcessingPassEnd();
|
|
|
|
void OnStreamEnd();
|
|
|
|
void OnBufferStart([in] void* pBufferContext);
|
|
|
|
void OnBufferEnd([in] void* pBufferContext);
|
|
|
|
void OnLoopEnd([in] void* pBufferContext);
|
|
|
|
void OnVoiceError(
|
|
[in] void* pBuffercontext,
|
|
[in] HRESULT Error);
|
|
}
|
|
|
|
[
|
|
object,
|
|
local
|
|
]
|
|
interface IXAudio2VoiceCallback
|
|
{
|
|
void OnVoiceProcessingPassStart([in] UINT32 BytesRequired);
|
|
|
|
void OnVoiceProcessingPassEnd();
|
|
|
|
void OnStreamEnd();
|
|
|
|
void OnBufferStart([in] void* pBufferContext);
|
|
|
|
void OnBufferEnd([in] void* pBufferContext);
|
|
|
|
void OnLoopEnd([in] void* pBufferContext);
|
|
|
|
void OnVoiceError(
|
|
[in] void* pBuffercontext,
|
|
[in] HRESULT Error);
|
|
}
|
|
|
|
typedef struct XAUDIO2_DEBUG_CONFIGURATION
|
|
{
|
|
UINT32 TraceMask;
|
|
UINT32 BreakMask;
|
|
BOOL LogThreadID;
|
|
BOOL LogFileline;
|
|
BOOL LogFunctionName;
|
|
BOOL LogTiming;
|
|
} XAUDIO2_DEBUG_CONFIGURATION;
|
|
|
|
[
|
|
object,
|
|
uuid(8bcf1f58-9fe7-4583-8ac6-e2adc465c8bb), /* all versions before 28 share IID_IXAudio */
|
|
]
|
|
/* XAudio2 2.0's IXAudio2 interface. Actually called IXAudio2 in the Mar 2008
|
|
* DX SDK */
|
|
interface IXAudio20 : IUnknown
|
|
{
|
|
HRESULT GetDeviceCount([out] UINT32* pCount);
|
|
|
|
HRESULT GetDeviceDetails(
|
|
[in] UINT32 Index,
|
|
[out] XAUDIO2_DEVICE_DETAILS* pDeviceDetails);
|
|
|
|
HRESULT Initialize(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_PROCESSOR)] XAUDIO2_PROCESSOR XAudio2Processor);
|
|
|
|
HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
HRESULT CreateSourceVoice(
|
|
[out] IXAudio2SourceVoice** ppSourceVoice,
|
|
[in] const WAVEFORMATEX* pSourceFormat,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
|
|
[in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateSubmixVoice(
|
|
[out] IXAudio2SubmixVoice** ppSubmixVoice,
|
|
[in] UINT32 InputChannels,
|
|
[in] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 ProcessingStage,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateMasteringVoice(
|
|
[out] IXAudio2MasteringVoice** ppMasteringVoice,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 DeviceIndex,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT StartEngine();
|
|
|
|
void StopEngine();
|
|
|
|
HRESULT CommitChanges([in] UINT32 OperationSet);
|
|
|
|
void GetPerformanceData([out] XAUDIO20_PERFORMANCE_DATA* pPerfData);
|
|
|
|
[local] void SetDebugConfiguration(
|
|
[in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
|
|
[in, defaultvalue(NULL)] void* pReserved);
|
|
}
|
|
|
|
[
|
|
object,
|
|
uuid(8bcf1f58-9fe7-4583-8ac6-e2adc465c8bb), /* all versions before 28 share IID_IXAudio */
|
|
]
|
|
/* XAudio2 2.2's IXAudio2 interface. Actually called IXAudio2 in the Jun 2010
|
|
* DX SDK */
|
|
interface IXAudio22 : IUnknown
|
|
{
|
|
HRESULT GetDeviceCount([out] UINT32* pCount);
|
|
|
|
HRESULT GetDeviceDetails(
|
|
[in] UINT32 Index,
|
|
[out] XAUDIO2_DEVICE_DETAILS* pDeviceDetails);
|
|
|
|
HRESULT Initialize(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_PROCESSOR)] XAUDIO2_PROCESSOR XAudio2Processor);
|
|
|
|
HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
HRESULT CreateSourceVoice(
|
|
[out] IXAudio2SourceVoice** ppSourceVoice,
|
|
[in] const WAVEFORMATEX* pSourceFormat,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
|
|
[in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateSubmixVoice(
|
|
[out] IXAudio2SubmixVoice** ppSubmixVoice,
|
|
[in] UINT32 InputChannels,
|
|
[in] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 ProcessingStage,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateMasteringVoice(
|
|
[out] IXAudio2MasteringVoice** ppMasteringVoice,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 DeviceIndex,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT StartEngine();
|
|
|
|
void StopEngine();
|
|
|
|
HRESULT CommitChanges([in] UINT32 OperationSet);
|
|
|
|
void GetPerformanceData([out] XAUDIO22_PERFORMANCE_DATA* pPerfData);
|
|
|
|
[local] void SetDebugConfiguration(
|
|
[in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
|
|
[in, defaultvalue(NULL)] void* pReserved);
|
|
}
|
|
|
|
[
|
|
object,
|
|
uuid(8bcf1f58-9fe7-4583-8ac6-e2adc465c8bb), /* all versions before 28 share IID_IXAudio */
|
|
]
|
|
/* XAudio2 2.3's IXAudio2 interface. Actually called IXAudio2 in the Nov 2008
|
|
* DX SDK */
|
|
interface IXAudio23 : IUnknown
|
|
{
|
|
HRESULT GetDeviceCount([out] UINT32* pCount);
|
|
|
|
HRESULT GetDeviceDetails(
|
|
[in] UINT32 Index,
|
|
[out] XAUDIO2_DEVICE_DETAILS* pDeviceDetails);
|
|
|
|
HRESULT Initialize(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_PROCESSOR)] XAUDIO2_PROCESSOR XAudio2Processor);
|
|
|
|
HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
HRESULT CreateSourceVoice(
|
|
[out] IXAudio2SourceVoice** ppSourceVoice,
|
|
[in] const WAVEFORMATEX* pSourceFormat,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
|
|
[in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateSubmixVoice(
|
|
[out] IXAudio2SubmixVoice** ppSubmixVoice,
|
|
[in] UINT32 InputChannels,
|
|
[in] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 ProcessingStage,
|
|
[in, defaultvalue(NULL)] const XAUDIO23_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateMasteringVoice(
|
|
[out] IXAudio2MasteringVoice** ppMasteringVoice,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 DeviceIndex,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT StartEngine();
|
|
|
|
void StopEngine();
|
|
|
|
HRESULT CommitChanges([in] UINT32 OperationSet);
|
|
|
|
void GetPerformanceData([out] XAUDIO2_PERFORMANCE_DATA* pPerfData);
|
|
|
|
[local] void SetDebugConfiguration(
|
|
[in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
|
|
[in, defaultvalue(NULL)] void* pReserved);
|
|
}
|
|
|
|
[
|
|
object,
|
|
uuid(8bcf1f58-9fe7-4583-8ac6-e2adc465c8bb),
|
|
]
|
|
/* XAudio2 2.7's IXAudio2 interface. Actually called IXAudio2 in the Jun 2010
|
|
* DX SDK */
|
|
interface IXAudio27 : IUnknown
|
|
{
|
|
HRESULT GetDeviceCount([out] UINT32* pCount);
|
|
|
|
HRESULT GetDeviceDetails(
|
|
[in] UINT32 Index,
|
|
[out] XAUDIO2_DEVICE_DETAILS* pDeviceDetails);
|
|
|
|
HRESULT Initialize(
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_PROCESSOR)] XAUDIO2_PROCESSOR XAudio2Processor);
|
|
|
|
HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
HRESULT CreateSourceVoice(
|
|
[out] IXAudio2SourceVoice** ppSourceVoice,
|
|
[in] const WAVEFORMATEX* pSourceFormat,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
|
|
[in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateSubmixVoice(
|
|
[out] IXAudio2SubmixVoice** ppSubmixVoice,
|
|
[in] UINT32 InputChannels,
|
|
[in] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 ProcessingStage,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateMasteringVoice(
|
|
[out] IXAudio2MasteringVoice** ppMasteringVoice,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 DeviceIndex,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT StartEngine();
|
|
|
|
void StopEngine();
|
|
|
|
HRESULT CommitChanges([in] UINT32 OperationSet);
|
|
|
|
void GetPerformanceData([out] XAUDIO2_PERFORMANCE_DATA* pPerfData);
|
|
|
|
[local] void SetDebugConfiguration(
|
|
[in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
|
|
[in, defaultvalue(NULL)] void* pReserved);
|
|
}
|
|
|
|
/* XAudio2 2.8's IXAudio2 is identical to 2.9's */
|
|
cpp_quote("DEFINE_GUID(IID_IXAudio28, 0x60d8dac8, 0x5aa1, 0x4e8e, 0xb5, 0x97, 0x2f, 0x5e, 0x28, 0x83, 0xd4, 0x84);")
|
|
|
|
[
|
|
object,
|
|
uuid(2b02e3cf-2e0b-4ec3-be45-1b2a3fe7210d)
|
|
]
|
|
/* XAudio2 2.9's IXAudio2 interface. */
|
|
interface IXAudio2 : IUnknown
|
|
{
|
|
HRESULT RegisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
void UnregisterForCallbacks([in] IXAudio2EngineCallback* pCallback);
|
|
|
|
HRESULT CreateSourceVoice(
|
|
[out] IXAudio2SourceVoice** ppSourceVoice,
|
|
[in] const WAVEFORMATEX* pSourceFormat,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_FREQ_RATIO)] float MaxFrequencyRatio,
|
|
[in, defaultvalue(NULL)] IXAudio2VoiceCallback* pCallback,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateSubmixVoice(
|
|
[out] IXAudio2SubmixVoice** ppSubmixVoice,
|
|
[in] UINT32 InputChannels,
|
|
[in] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(0)] UINT32 ProcessingStage,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_VOICE_SENDS* pSendList,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain);
|
|
|
|
HRESULT CreateMasteringVoice(
|
|
[out] IXAudio2MasteringVoice** ppMasteringVoice,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_CHANNELS)] UINT32 InputChannels,
|
|
[in, defaultvalue(XAUDIO2_DEFAULT_SAMPLERATE)] UINT32 InputSampleRate,
|
|
[in, defaultvalue(0)] UINT32 Flags,
|
|
[in, defaultvalue(NULL)] LPCWSTR DeviceId,
|
|
[in, defaultvalue(NULL)] const XAUDIO2_EFFECT_CHAIN* pEffectChain,
|
|
[in, defaultvalue(AudioCategory_GameEffects)] AUDIO_STREAM_CATEGORY StreamCategory);
|
|
|
|
HRESULT StartEngine();
|
|
|
|
void StopEngine();
|
|
|
|
HRESULT CommitChanges([in] UINT32 OperationSet);
|
|
|
|
void GetPerformanceData([out] XAUDIO2_PERFORMANCE_DATA* pPerfData);
|
|
|
|
[local] void SetDebugConfiguration(
|
|
[in] const XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration,
|
|
[in, defaultvalue(NULL)] void* pReserved);
|
|
}
|
|
|
|
const UINT32 XAUDIO2_DEBUG_ENGINE = 1;
|
|
const UINT32 XAUDIO2_VOICE_NOPITCH = 2;
|
|
const UINT32 XAUDIO2_VOICE_NOSRC = 4;
|
|
const UINT32 XAUDIO2_VOICE_USEFILTER = 8;
|
|
const UINT32 XAUDIO2_VOICE_MUSIC = 16;
|
|
const UINT32 XAUDIO2_PLAY_TAILS = 32;
|
|
const UINT32 XAUDIO2_END_OF_STREAM = 64;
|
|
const UINT32 XAUDIO2_SEND_USEFILTER = 128;
|
|
const UINT32 XAUDIO2_VOICE_NOSAMPLESPLAYED = 256;
|
|
|
|
const XAUDIO2_FILTER_TYPE XAUDIO2_DEFAULT_FILTER_TYPE = LowPassFilter;
|
|
const float XAUDIO2_DEFAULT_FILTER_FREQUENCY = XAUDIO2_MAX_FILTER_FREQUENCY;
|
|
const float XAUDIO2_DEFAULT_FILTER_ONEOVERQ = 1.0;
|
|
const UINT32 XAUDIO2_QUANTUM_NUMERATOR = 1;
|
|
const UINT32 XAUDIO2_QUANTUM_DENOMINATOR = 100;
|
|
const float XAUDIO2_QUANTUM_MS = (1000.0 * XAUDIO2_QUANTUM_NUMERATOR / XAUDIO2_QUANTUM_DENOMINATOR);
|
|
|
|
/* use cpp_quote to retain the HRESULT type in header file */
|
|
cpp_quote("#define XAUDIO2_E_INVALID_CALL ((HRESULT)0x88960001)")
|
|
cpp_quote("#define XAUDIO2_E_XMA_DECODER_ERROR ((HRESULT)0x88960002)")
|
|
cpp_quote("#define XAUDIO2_E_XAPO_CREATION_FAILED ((HRESULT)0x88960003)")
|
|
cpp_quote("#define XAUDIO2_E_DEVICE_INVALIDATED ((HRESULT)0x88960004)")
|
|
|
|
/* xaudio 2.0 error codes */
|
|
cpp_quote("#define XAUDIO20_E_XMA_DECODER_ERROR ((HRESULT)0x88960001)")
|
|
cpp_quote("#define XAUDIO20_E_XAPO_CREATION_FAILED ((HRESULT)0x88960002)")
|
|
cpp_quote("#define XAUDIO20_E_DEVICE_INVALIDATED ((HRESULT)0x88960003)")
|
|
|
|
cpp_quote("#ifdef XAUDIO2_HELPER_FUNCTIONS")
|
|
cpp_quote("#define _USE_MATH_DEFINES")
|
|
cpp_quote("#include <math.h>")
|
|
cpp_quote("inline static float XAudio2DecibelsToAmplitudeRatio(float decibels) { return powf(10.0f, decibels/20.0f); }")
|
|
cpp_quote("inline static float XAudio2AmplitudeRatioToDecibels(float volume) { if (volume == 0) { return -3.402823466e+38f; } return 20.0f * log10f(volume); }")
|
|
cpp_quote("inline static float XAudio2SemitonesToFrequencyRatio(float semitones) { return powf(2.0f, semitones/12.0f); }")
|
|
cpp_quote("inline static float XAudio2FrequencyRatioToSemitones(float freqratio) { return 39.86313713864835f * log10f(freqratio); }")
|
|
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); }")
|
|
cpp_quote("inline static float XAudio2RadiansToCutoffFrequency(float radians, float samplerate) { return samplerate * asinf(radians/2.0f) / (float)M_PI; }")
|
|
cpp_quote("#endif")
|
|
|
|
cpp_quote("HRESULT WINAPI XAudio2Create(IXAudio2** pxaudio2, UINT32 flags, XAUDIO2_PROCESSOR processor);")
|
|
|
|
cpp_quote("#include <poppack.h>")
|