Metodo IXAudio2SourceVoice::GetState (xaudio2.h)

  • Articolo

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

Vedi anche

Procedura: Trasmissione di un suono in un flusso da disco

IXAudio2SourceVoice