IXAudio2 interface (xaudio2.h)
IXAudio2 is the interface for the XAudio2 object that manages all audio engine states, the audio processing thread, the voice graph, and so forth.
This is the only XAudio2 interface that is derived from the COM IUnknown interface. It controls the lifetime of the XAudio2 object using two methods derived from IUnknown: IXAudio2::AddRef and IXAudio2::Release. No other XAudio2 objects are reference-counted; their lifetimes are explicitly controlled using create and destroy calls, and are bounded by the lifetime of the XAudio2 object that owns them.
Inheritance
The IXAudio2 Interface interface inherits from the IUnknown interface. IXAudio2 also has these types of members:
Methods
The IXAudio2 interface has these methods.
| IXAudio2::AddRef Adds a reference to the XAudio2 object. |
| IXAudio2::CommitChanges Atomically applies a set of operations that are tagged with a given identifier. |
| IXAudio2::CreateMasteringVoice Creates and configures a mastering voice. |
| IXAudio2::CreateSourceVoice Creates and configures a source voice. |
| IXAudio2::CreateSubmixVoice Creates and configures a submix voice. |
| IXAudio2::GetPerformanceData Returns current resource usage details, such as available memory or CPU usage. |
| IXAudio2::QueryInterface Queries for a given COM interface on the XAudio2 object. |
| IXAudio2::RegisterForCallbacks Adds an IXAudio2EngineCallback pointer to the XAudio2 engine callback list. |
| IXAudio2::Release Releases a reference to the XAudio2 object. |
| IXAudio2::SetDebugConfiguration Changes global debug logging options for XAudio2. |
| IXAudio2::StartEngine Starts the audio processing thread. |
| IXAudio2::StopEngine Stops the audio processing thread. |
| IXAudio2::UnregisterForCallbacks Removes an IXAudio2EngineCallback pointer from the XAudio2 engine callback list. |
Remarks
The DirectX SDK versions of XAUDIO2 included three member functions that are not present in the Windows 8 version: GetDeviceCount, GetDeviceDetails, and Initialize. These enumeration methods are no longer provided and standard Windows Audio APIs should be used for device enumeration instead.
Platform Requirements
Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | xaudio2.h |