IAgentCharacterEx::GetSRModeID

[Microsoft Agent ist ab Version Windows 7 veraltet und in nachfolgenden Versionen von Windows.]

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

Ruft die Modus-ID des Für das Zeichen festgelegten Spracherkennungsmoduls ab.

  • Gibt S _ OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

pbszModeID

Adresse eines BSTR, der die Modus-ID-Einstellung der Spracherkennungs-Engine für das Zeichen empfängt.

Diese Einstellung gibt den Engine-Satz für die Spracheingabe eines Zeichens zurück. Die Modus-ID für eine Spracherkennungs-Engine ist eine Zeichenfolgendarstellung der GUID (formatiert mit geschweiften Klammern und Bindestrichen) des Sprachanbieters, der die Engine eindeutig identifiziert. Weitere Informationen finden Sie in der Dokumentation zum Microsoft Speech SDK.

Wenn Sie keine Spracherkennungs-Engine-Modus-ID für das Zeichen festlegen, gibt der Server eine Engine zurück, die der Spracheinstellung des Zeichens entspricht (mithilfe von Microsoft Speech-API-Schnittstellen). Wenn für das Zeichen keine entsprechende Spracherkennungs-Engine verfügbar ist, gibt der Server eine (leere) NULL-Zeichenfolge zurück.

Wenn die Spracheingabe aktiviert ist (im Fenster Erweiterte Zeichenoptionen), wird beim Abfragen oder Festlegen dieser Eigenschaft die zugeordnete Engine geladen (sofern sie noch nicht geladen ist) und die Spracherkennungsdienste gestartet. Das heißt, die Abhörtaste ist verfügbar, und der Tipp zum Lauschen wird angezeigt. (Die Abhörtaste und der Lauschende Tipp sind nur aktiviert, wenn sie auch unter Erweiterte Zeichenoptionen aktiviert sind.) Wenn Sie jedoch die -Eigenschaft abfragen, wenn Sprache deaktiviert ist, startet der Server keine Sprachdienste und gibt eine NULL-Zeichenfolge (leere Zeichenfolge) zurück.

Diese Funktion gibt nur die Einstellung für die Verwendung des Zeichens durch Ihre Clientanwendung zurück. Die Einstellung spiegelt keine anderen Clients des Zeichens oder anderer Zeichen Ihrer Clientanwendung wider.

Diese Funktion führt nicht zu einem Fehler, wenn IAgentSpeechInputProperties::GetEnabled false zurückgibt.

Die Anforderungen an die Sprach-Engine von Microsoft Agent basieren auf der Microsoft Speech-API. Engines, die die SAPI-Anforderungen von Microsoft Agent unterstützen, können mit dem -Agent installiert und verwendet werden.

Weitere Informationen

IAgentCharacterEx::SetSRModeID