IXAudio2-Schnittstelle (xaudio2.h)
IXAudio2 ist die Schnittstelle für das XAudio2-Objekt , das alle Audio-Engine-Zustände, den Audioverarbeitungsthread, das Stimmdiagramm usw. verwaltet.
Dies ist die einzige XAudio2-Schnittstelle, die von der COM-IUnknown-Schnittstelle abgeleitet wird. Sie steuert die Lebensdauer des XAudio2-Objekts mithilfe von zwei methoden, die von IUnknown abgeleitet werden: IXAudio2::AddRef und IXAudio2::Release. Keine anderen XAudio2-Objekte werden mit Verweis gezählt. ihre Lebensdauer wird explizit mithilfe von Create - und Destroy-Aufrufen gesteuert und durch die Lebensdauer des XAudio2-Objekts begrenzt, das sie besitzt.
Vererbung
Die IXAudio2-Schnittstelle erbt von der IUnknown-Schnittstelle . IXAudio2 verfügt auch über folgende Arten von Membern:
Methoden
Die IXAudio2-Schnittstelle verfügt über diese Methoden.
| IXAudio2::AddRef Fügt einen Verweis auf das XAudio2-Objekt hinzu. |
| IXAudio2::CommitChanges Wendet atomar eine Reihe von Vorgängen an, die mit einem bestimmten Bezeichner gekennzeichnet sind. |
| IXAudio2::CreateMasteringVoice Erstellt und konfiguriert eine Masterstimme. |
| IXAudio2::CreateSourceVoice Erstellt und konfiguriert eine Quellstimme. |
| IXAudio2::CreateSubmixVoice Erstellt und konfiguriert eine Submixstimme. |
| IXAudio2::GetPerformanceData Gibt Details zur aktuellen Ressourcennutzung zurück, z. B. verfügbarer Arbeitsspeicher oder CPU-Auslastung. |
| IXAudio2::QueryInterface Abfragen für eine bestimmte COM-Schnittstelle für das XAudio2-Objekt. |
| IXAudio2::RegisterForCallbacks Fügt der Rückrufliste der XAudio2-Engine einen IXAudio2EngineCallback-Zeiger hinzu. |
| IXAudio2::Release Gibt einen Verweis auf das XAudio2-Objekt frei. |
| IXAudio2::SetDebugConfiguration Ändert die globalen Debugprotokollierungsoptionen für XAudio2. |
| IXAudio2::StartEngine Startet den Audioverarbeitungsthread. |
| IXAudio2::StopEngine Beendet den Audioverarbeitungsthread. |
| IXAudio2::UnregisterForCallbacks Entfernt einen IXAudio2EngineCallback-Zeiger aus der Rückrufliste der XAudio2-Engine. |
Hinweise
Die DirectX SDK-Versionen von XAUDIO2 enthalten drei Memberfunktionen, die in der Windows 8-Version nicht vorhanden sind: GetDeviceCount, GetDeviceDetails und Initialize. Diese Enumerationsmethoden werden nicht mehr bereitgestellt, und stattdessen sollten standardmäßige Windows-Audio-APIs für die Geräteenumeration verwendet werden.
Plattformanforderungen
Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | xaudio2.h |