IXAudio2SourceVoice::GetState-Methode (xaudio2.h)

  • Artikel

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

Weitere Informationen

So wird's gemacht: Streamen von Sound von einem Datenträger

IXAudio2SourceVoice