IXAudio2SourceVoice::GetState-Methode (xaudio2.h)
Gibt die aktuellen Cursorpositionsdaten der Stimme zurück.
Syntax
void GetState(
XAUDIO2_VOICE_STATE *pVoiceState,
[optional] UINT32 Flags
);
Parameter
pVoiceState
Zeiger auf eine XAUDIO2_VOICE_STATE Struktur, die den Zustand der Stimme enthält.
[optional] Flags
Flags steuern, welche Sprachzustandsdaten zurückgegeben werden sollen. Gültige Werte sind 0 oder XAUDIO2_VOICE_NOSAMPLESPLAYED. Der Standardwert ist 0. Wenn Sie XAUDIO2_VOICE_NOSAMPLESPLAYED angeben, gibt GetState nur den Pufferzustand und nicht den Samplerzustand zurück. GetState benötigt etwa ein Drittel so viel Zeit, bis sie abgeschlossen ist, wenn Sie XAUDIO2_VOICE_NOSAMPLESPLAYED angeben.
Rückgabewert
Keine
Bemerkungen
Wenn ein Client die korrelierten Positionen mehrerer Stimmen abrufen muss (z. B. um genau zu wissen, welches Beispiel einer bestimmten Stimme wiedergegeben wird, wenn ein bestimmtes Beispiel einer anderen Stimme wiedergegeben wird), muss er GetState-Anrufe in einem Rückruf der XAudio2-Engine durchführen. Dadurch wird sichergestellt, dass keine der Stimmen voranschreiten, während die Anrufe getätigt werden. Informationen zur Verwendung von XAudio2-Rückrufen finden Sie in der Übersicht über XAudio2-Rückrufe.
Beachten Sie, dass die DirectX SDK-Versionen von XAUDIO2 den Parameter Flags für GetState nicht verwenden.
Plattformanforderungen
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | xaudio2.h |