IAgentCharacterEx::GetSRModeID

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

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

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

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

pbszModeID-

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

Diese Einstellung gibt den Modulsatz für die Spracheingabe eines Zeichens zurück. Die Modus-ID für ein Spracherkennungsmodul ist eine Zeichenfolgendarstellung der GUID (formatiert mit geschweiften Klammern und Gedankenstrichen) durch den Sprachanbieter, der das Modul eindeutig identifiziert. Weitere Informationen finden Sie in der Microsoft Speech SDK-Dokumentation.

Wenn Sie keine Id für den Spracherkennungsmodulmodus für das Zeichen festlegen, gibt der Server ein Modul zurück, das der Spracheinstellung des Zeichens entspricht (mithilfe von Microsoft Speech API-Schnittstellen). Wenn kein passendes Spracherkennungsmodul für das Zeichen verfügbar ist, gibt der Server eine NULL-Zeichenfolge (leere) zurück.

Wenn die Spracheingabe aktiviert ist (im Fenster "Erweiterte Zeichenoptionen"), wird durch Abfragen oder Festlegen dieser Eigenschaft das zugeordnete Modul geladen (sofern sie noch nicht geladen ist) und Spracherkennungsdienste gestartet. Das heißt, die Hörtaste ist verfügbar, und der Hörhinweis kann angezeigt werden. (Die Zuhören-Taste und der Zuhören-Tipp sind nur aktiviert, wenn sie auch in erweiterten Zeichenoptionen aktiviert sind.) Wenn Sie die Eigenschaft jedoch abfragen, wenn die Spracherkennung 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 ihrer Clientanwendung zurück. die Einstellung enthält keine anderen Clients des Zeichens oder anderer Zeichen Ihrer Clientanwendung.

Diese Funktion schlägt nicht fehl, wenn die IAgentSpeechInputProperties::GetEnabledFalse-zurückgibt.

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

Siehe auch

IAgentCharacterEx::SetSRModeID