Método IXAudio2SourceVoice::GetState (xaudio2.h)
Devuelve los datos de posición actual del cursor de la voz.
Sintaxis
void GetState(
XAUDIO2_VOICE_STATE *pVoiceState,
[optional] UINT32 Flags
);
Parámetros
pVoiceState
Puntero a una estructura de XAUDIO2_VOICE_STATE que contiene el estado de la voz.
[optional] Flags
Marcas que controlan qué datos de estado de voz se deben devolver. Los valores válidos son 0 o XAUDIO2_VOICE_NOSAMPLESPLAYED. El valor predeterminado es 0. Si especifica XAUDIO2_VOICE_NOSAMPLESPLAYED, GetState devuelve solo el estado del búfer, no el estado del sampler. GetState tarda aproximadamente un tercio en completarse al especificar XAUDIO2_VOICE_NOSAMPLESPLAYED.
Valor devuelto
None
Observaciones
Si un cliente necesita obtener las posiciones correlacionadas de varias voces (por ejemplo, para saber exactamente qué muestra de una voz determinada se está reproduciendo cuando se reproduce una muestra determinada de otra voz), debe realizar llamadas GetState en una devolución de llamada del motor XAudio2. Esto garantiza que ninguna de las voces avance mientras se realizan las llamadas. Consulte la información general sobre devoluciones de llamada de XAudio2 para obtener información sobre el uso de devoluciones de llamada de XAudio2.
Tenga en cuenta que las versiones del SDK de DirectX de XAUDIO2 no toman el parámetro Flags para GetState.
Requisitos de la plataforma
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | xaudio2.h |