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 |