Metodo IXAudio2SourceVoice::GetState (xaudio2.h)
Restituisce i dati sulla posizione corrente del cursore della voce.
Sintassi
void GetState(
XAUDIO2_VOICE_STATE *pVoiceState,
[optional] UINT32 Flags
);
Parametri
pVoiceState
Puntatore a una struttura XAUDIO2_VOICE_STATE contenente lo stato della voce.
[optional] Flags
Flag che controllano quali dati di stato voce devono essere restituiti. I valori validi sono 0 o XAUDIO2_VOICE_NOSAMPLESPLAYED. Il valore predefinito è 0. Se si specifica XAUDIO2_VOICE_NOSAMPLESPLAYED, GetState restituisce solo lo stato del buffer, non lo stato del campionatore. Il completamento di GetState richiede circa un terzo del tempo quando si specifica XAUDIO2_VOICE_NOSAMPLESPLAYED.
Valore restituito
nessuno
Osservazioni
Se un client deve ottenere le posizioni correlate di diverse voci (ad esempio, per sapere esattamente quale campione di una determinata voce viene riprodotta quando viene riprodotto un determinato campione di un'altra voce), deve effettuare chiamate GetState in un callback del motore XAudio2. Ciò garantisce che nessuna delle voci avanza durante l'esecuzione delle chiamate. Per informazioni sull'uso dei callback XAudio2, vedere la panoramica dei callback di XAudio2 .
Si noti che le versioni di DirectX SDK di XAUDIO2 non accettano il parametro Flags per GetState.
Requisiti della piattaforma
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | xaudio2.h |