IAgentCharacterEx::GetSRStatus
[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]
HRESULT GetSRStatus(
long * plStatus // address of the speech input status
);
Récupère l’état de la condition nécessaire pour prendre en charge l’entrée vocale.
- Retourne _ la valeur 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 État d’écoute longue non signée const _ _ CANLISTEN = 0 ; Les conditions prennent en charge l’entrée vocale. const unsigned long Listen _ Status _ noaudio = 1 ; Aucun périphérique d’entrée audio n’est disponible sur ce système. (Notez que cela ne détecte pas si un microphone est installé ; il peut détecter uniquement si l’utilisateur dispose d’une carte son compatible avec un pilote opérationnel.) État d’écoute longue non signée const _ _ NOTTOPMOST = 2 ; Un autre client est le client actif de ce caractère, ou le caractère actuel n’est pas au premier plan. État d’écoute longue non signée const _ _ CANTOPENAUDIO = 3 ; Le canal d’entrée ou de sortie audio est actuellement occupé, mais une autre application utilise l’audio. État d’écoute longue non signée const _ _ COULDNTINITIALIZESPEECH = 4 ; Une erreur non spécifiée s’est produite lors de l’initialisation du sous-système de reconnaissance vocale. Cela inclut la possibilité qu’aucun moteur vocal ne soit disponible correspondant au paramètre de langue du caractère. État d’écoute longue non signée const _ _ SPEECHDISABLED = 5 ; L’utilisateur a désactivé l’entrée vocale dans la fenêtre Options de caractères avancés. erreur d’état d’écoute longue non signée const _ _ = 6 ; Une erreur s’est produite lors de la vérification de l’État audio, mais la cause de l’erreur n’a pas été retournée par le système.
Cette fonction vous permet d’interroger si les conditions actuelles prennent en charge l’entrée de reconnaissance vocale, y compris l’état du périphérique audio. Si votre application utilise la méthode IAgentCharacterEx :: Listen , vous pouvez utiliser cette fonction pour mieux garantir le bon fonctionnement de l’appel. L’appel de cette méthode charge également le moteur de reconnaissance vocale s’il n’est pas déjà chargé. Toutefois, il n’active pas le mode d’écoute.
Lorsque l’entrée vocale est activée dans la feuille de propriétés de l’agent (options de caractères avancés), l’interrogation de l’état chargera le moteur associé (s’il n’est pas déjà chargé) et démarrez Speech services. Autrement dit, la clé d’écoute est disponible et l’info-bulle d’écoute est affichable. (La clé d’écoute et l’info-bulle d’écoute sont activées uniquement si elles sont également activées dans les options de caractères avancés.) Toutefois, si vous interrogez la propriété alors que la reconnaissance vocale est désactivée, le serveur ne démarre pas les services vocaux.
Cette fonction retourne uniquement le paramètre de l’utilisation du caractère par l’application cliente ; le paramètre ne reflète pas les autres clients du caractère ou d’autres caractères de votre application cliente.