Freigeben über

IAgentUserInput::GetAllItemData

  • Artikel

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

HRESULT GetAllItemData(
   VARIANT * pdwItemIndices,  // address of variable for alternative IDs
   VARIANT * plConfidences,   // address of variable for confidence scores
   VARIANT * pbszText         // address of variable for voice text
);

Ruft die Daten für alle Befehlsalternativen ab, die an einen IAgentNotifySink::Command-Rückruf übergeben werden.

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

pdwItemIndices

Adresse einer Variablen, die die IDs von Befehlen empfängt , die an den IAgentNotifySink::Command-Rückruf übergeben werden.

plConfidences

Adresse einer Variablen, die die Zuverlässigkeitsbewertungen für Befehlsalternativen empfängt, die an den IAgentNotifySink::Command-Rückruf übergeben werden.

pbszText

Adresse einer Variablen, die den Sprachtext für Befehlsalternativen empfängt, die an den IAgentNotifySink::Command-Rückruf übergeben werden.

Wenn die Spracheingabe IAgentNotifySink::Command auslöst, gibt der Server die beste Übereinstimmung, die zweitbeste Übereinstimmung und die drittbeste Übereinstimmung zurück, wenn diese von der Sprach-Engine bereitgestellt werden. Sie stellt die relativen Zuverlässigkeitsbewertungen im Bereich von -100 bis 100 und den tatsächlichen Text bereit, der von der Sprach-Engine gehört wird. Wenn die beste Übereinstimmung mit einem vom Server bereitgestellten Befehl war, sendet der Server eine NULL-ID, aber weiterhin eine Konfidenzbewertung und den Sprachtext .

Wenn die Spracheingabe nicht die Quelle für das Ereignis war; Wenn der Benutzer beispielsweise den Befehl aus dem Popupmenü des Zeichens ausgewählt hat, gibt der Microsoft-Agent-Server die ID des ausgewählten Befehls mit einer Zuverlässigkeitsbewertung von 100 und dem Sprachtext als NULL zurück. Die anderen Alternativen geben als NULL mit Konfidenzwerten von null (0) und Sprachtext als NULL zurück.

Hinweis

Nicht alle Spracherkennungs-Engines geben möglicherweise alle Werte für alle Parameter dieses Ereignisses zurück. Wenden Sie sich an Ihren Engine-Anbieter, um zu ermitteln, ob die Engine die Microsoft Speech-API-Schnittstelle unterstützt, um Alternativen und Zuverlässigkeitsbewertungen zurückzugeben.

 

Weitere Informationen

IAgentUserInput::GetItemConfidence, IAgentUserInput::GetItemText, IAgentUserInput::GetItemID