Partager via

IAgentAudioOutputPropertiesEx::GetStatus

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT GetStatus(
   long * plStatus,  // address of audio channel status
);

Permet de connaître l'état de la chaîne audio.

  • Renvoie S_OK pour indiquer que l'opération a réussi.

plStatus

État de la chaîne de sortie audio, qui peut prendre l'une des valeurs suivantes :

Valeur Description
const unsigned short AUDIO_STATUS_AVAILABLE = 0;
 La chaîne de sortie audio est disponible (non occupée).
const unsigned short AUDIO_STATUS_NOAUDIO = 1;
 La sortie audio n'est pas prise en charge, par exemple parce qu'il n'y a pas de carte son.
const unsigned short AUDIO_STATUS_CANTOPENAUDIO = 2;
 La chaîne de sortie audio ne peut pas être ouverte (est occupée) ; par exemple, parce qu'une autre application joue de l'audio.
const unsigned short AUDIO_STATUS_USERSPEAKING = 3;
 La chaîne de sortie audio est occupée parce que le serveur traite les données vocales de l'utilisateur.
const unsigned short AUDIO_STATUS_CHARACTERSPEAKING = 4;
 La chaîne de sortie audio est occupée parce qu'un personnage est en train de parler.
const unsigned short AUDIO_STATUS_SROVERRIDEABLE = 5;
 La chaîne de sortie audio n'est pas occupée, mais elle est en attente d'une entrée vocale de l'utilisateur.
const unsigned short AUDIO_STATUS_ERROR = 6;
 Un autre problème (inconnu) s'est produit lors de la tentative d'accès à la chaîne de sortie audio.

Ce paramètre permet à votre application cliente d'interroger l'état de la chaîne de sortie audio. Vous pouvez l'utiliser pour déterminer si votre personnage doit parler ou essayer d'activer le mode d'écoute (en utilisant IAgentCharacterEx::Listen).