Método IXAudio2SourceVoice::GetState (xaudio2.h)

  • Artículo

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

Consulte también

Cómo: transmitir un sonido de un disco

IXAudio2SourceVoice