Partager via

IAgentCharacterEx::GetSRModeID

  • Article

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

HRESULT GetSRModeID(
   BSTR * pbszModeID  // address of speech recognition engine ID
);

Récupère l’ID de mode du moteur de reconnaissance vocale défini pour le caractère.

  • Retourne S_OK pour indiquer que l’opération a réussi.

pbszModeID

Adresse d’un BSTR qui reçoit le paramètre d’ID de mode du moteur de reconnaissance vocale pour le caractère.

Ce paramètre retourne le jeu de moteurs pour l’entrée vocale d’un caractère. L’ID de mode d’un moteur de reconnaissance vocale est une représentation sous forme de chaîne du GUID (mis en forme avec des accolades et des tirets) par le fournisseur de reconnaissance vocale identifiant de manière unique le moteur. Pour plus d’informations, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Speech.

Si vous ne définissez pas d’ID de mode du moteur de reconnaissance vocale pour le caractère, le serveur retourne un moteur qui correspond au paramètre de langue du caractère (à l’aide des interfaces de l’API Microsoft Speech). S’il n’existe aucun moteur de reconnaissance vocale correspondant disponible pour le caractère, le serveur retourne une chaîne null (vide).

Lorsque l’entrée vocale est activée (dans la fenêtre Options de caractères avancées), l’interrogation ou la définition de cette propriété charge le moteur associé (s’il n’est pas déjà chargé) et démarre les services vocaux. Autrement dit, la clé d’écoute est disponible et l’info-bulle d’écoute peut être affichée. (La touche d’écoute et le conseil d’écoute ne sont activés que s’ils sont également activés dans options de caractères avancés.) Toutefois, si vous interrogez la propriété lorsque la reconnaissance vocale est désactivée, le serveur ne démarre pas les services vocaux et retourne une chaîne Null (chaîne vide).

Cette fonction retourne uniquement le paramètre d’utilisation du caractère par votre application cliente ; le paramètre ne reflète pas les autres clients du caractère ou d’autres caractères de votre application cliente.

Cette fonction n’échoue pas si IAgentSpeechInputProperties::GetEnabled retourne False.

Les exigences du moteur speech de Microsoft Agent sont basées sur l’API Microsoft Speech. Les moteurs prenant en charge les exigences SAPI de Microsoft Agent peuvent être installés et utilisés avec Agent.

Voir aussi

IAgentCharacterEx::SetSRModeID