IXAudio2SourceVoice ::GetState, méthode (xaudio2.h)

Retourne les données actuelles de position du curseur de la voix.

Syntaxe

void GetState(
             XAUDIO2_VOICE_STATE *pVoiceState,
  [optional] UINT32              Flags
);

Paramètres

pVoiceState

Pointeur vers une structure XAUDIO2_VOICE_STATE contenant l’état de la voix.

[optional] Flags

Indicateurs contrôlant les données d’état de la voix qui doivent être retournées. Les valeurs valides sont 0 ou XAUDIO2_VOICE_NOSAMPLESPLAYED. La valeur par défaut est 0. Si vous spécifiez XAUDIO2_VOICE_NOSAMPLESPLAYED, GetState retourne uniquement l’état de mémoire tampon, pas l’état de l’échantillonneur. GetState prend environ un tiers de temps lorsque vous spécifiez XAUDIO2_VOICE_NOSAMPLESPLAYED.

Valeur de retour

None

Remarques

Si un client doit obtenir les positions corrélées de plusieurs voix (par exemple, pour savoir exactement quel échantillon d’une voix donnée est lu lorsqu’un échantillon donné d’une autre voix est en cours de lecture), il doit effectuer des appels GetState dans un rappel du moteur XAudio2. Cela garantit qu’aucune voix n’avance pendant que les appels sont effectués. Consultez la vue d’ensemble des rappels XAudio2 pour plus d’informations sur l’utilisation des rappels XAudio2.

Notez que les versions du Kit de développement logiciel (SDK) DirectX de XAUDIO2 ne prennent pas le paramètre Flags pour GetState.

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	xaudio2.h

Voir aussi

Procédure : diffuser un son en continu à partir du disque

IXAudio2SourceVoice