IAgentUserInput::GetAllItemData

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

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 Command Alternativen ab, die an eine 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 Commands empfängt, an den IAgentNotifySink::Command Rückruf übergeben.

plConfidences

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

pbszText-

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

Wenn die Spracheingabe IAgentNotifySink::Commandauslöst, gibt der Server die beste Übereinstimmung, die zweitbeste Übereinstimmung und die dritte beste Übereinstimmung zurück, wenn diese vom Sprachmodul bereitgestellt werden. Es stellt die relativen Konfidenzbewertungen im Bereich von -100 bis 100 und tatsächlichen Text "gehört" vom Sprachmodul bereit. Wenn die beste Übereinstimmung ein vom Server bereitgestellter Befehl war, sendet der Server eine NULL-ID, sendet aber trotzdem eine Konfidenzbewertung und den Voice--Text.

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 Konfidenzbewertung von 100 und Sprachtext als NULL zurück. Die anderen Alternativen geben als NULL mit Konfidenzwerten von Null (0) und Sprachtext als NULL zurück.

Anmerkung

Nicht alle Spracherkennungsmodule geben möglicherweise alle Werte für alle Parameter dieses Ereignisses zurück. Erkundigen Sie sich bei Ihrem Modulanbieter, ob das Modul die Microsoft Speech API-Schnittstelle für die Rückgabe von Alternativen und Konfidenzbewertungen unterstützt.

 

Siehe auch

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