IAgentCharacterEx::GetSRStatus

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

HRESULT GetSRStatus(
   long * plStatus  // address of the speech input status
);

Permet de connaître l'état de la condition nécessaire à la prise en charge de la saisie vocale.

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

plStatus

Adresse d'une variable qui reçoit l'une des valeurs suivantes pour le paramètre d'état :

Valeur	Description
const unsigned long LISTEN_STATUS_CANLISTEN = 0;	Les conditions prennent en charge la saisie vocale.
const unsigned long LISTEN_STATUS_NOAUDIO = 1;	Aucun appareil d'entrée audio n'est disponible sur ce système. (Notez que cela ne permet pas de détecter si un microphone est installé ; cela permet seulement de détecter si l'utilisateur dispose d'une carte son compatible avec la saisie et dont le pilote fonctionne).
const unsigned long LISTEN_STATUS_NOTTOPMOST = 2;	Un autre client est le client actif de ce personnage, ou le personnage actuel n'est pas le plus haut placé.
const unsigned long LISTEN_STATUS_CANTOPENAUDIO = 3;	La chaîne d'entrée ou de sortie audio est actuellement occupée, une autre application utilise l'audio.
const unsigned long LISTEN_STATUS_COULDNTINITIALIZESPEECH = 4;	Une erreur non spécifiée s'est produite lors de l'initialisation du sous-système de reconnaissance vocale. Il est possible qu'il n'y ait pas de moteur de reconnaissance vocale disponible correspondant à la langue du personnage.
const unsigned long LISTEN_STATUS_SPEECHDISABLED = 5;	L'utilisateur a désactivé la saisie vocale dans la fenêtre Options avancées des caractères.
const unsigned long LISTEN_STATUS_ERROR = 6;	Une erreur s'est produite lors de la vérification du statut audio, mais la cause de l'erreur n'a pas été renvoyée par le système.

Cette fonction vous permet de demander si les conditions actuelles prennent en charge la saisie par reconnaissance vocale, y compris l'état de l'appareil audio. Si votre application utilise la méthode IAgentCharacterEx::Listen, vous pouvez utiliser cette fonction pour mieux garantir la réussite de l'appel. L'appel de cette méthode charge également le moteur vocal s'il n'est pas déjà chargé. Cependant, elle n'active pas le mode d'écoute.

Lorsque la saisie vocale est activée dans la feuille de propriétés de l'agent (Options avancées des caractères), l'interrogation de l'état charge le moteur associé (s'il n'est pas déjà chargé) et démarre les services vocaux. Cela signifie que la touche d'écoute est disponible et que le conseil d'écoute peut être affiché. (La touche d'écoute et le conseil d'écoute ne sont activés que s'ils sont également activés dans les options avancées des caractères). Toutefois, si vous interrogez la propriété alors que la reconnaissance vocale est désactivée, le serveur ne démarre pas les services de reconnaissance vocale.

Cette fonction renvoie uniquement le paramètre correspondant à l'utilisation du personnage par votre application client ; le paramètre ne reflète pas les autres clients du personnage ou les autres caractères de votre application client.