IAgentUserInput::GetAllItemData

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

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
);

Hämtar data för alla Kommando alternativ som skickas till en IAgentNotifySink::Kommando återanrop.

• Returnerar S_OK för att indikera att åtgärden lyckades.

pdwItemIndices

Adress för en variabel som tar emot ID:t för kommandon skickas till IAgentNotifySink::Kommando återanrop.

plConfidences

Adress för en variabel som tar emot konfidenspoängen för Kommando alternativ som skickas till IAgentNotifySink::Kommando återanrop.

pbszText

Adress för en variabel som tar emot rösttexten för Kommando alternativ som skickas till IAgentNotifySink::Kommando återanrop.

Om talindata utlöses IAgentNotifySink::Commandreturnerar servern den bästa matchningen, den näst bästa matchningen och den tredje bästa matchningen om dessa tillhandahålls av talmotorn. Det ger de relativa konfidenspoängen, i intervallet -100 till 100, och faktisk text "hörd" av talmotorn. Om den bästa matchningen var ett kommando som tillhandahålls av servern skickar servern ett NULL-ID, men skickar fortfarande en konfidenspoäng och texten Voice.

Om talindata inte var källan för händelsen; Om användaren till exempel valde kommandot från tecknets popup-meny returnerar Microsoft Agent-servern ID:t för kommando valt, med en konfidenspoäng på 100 och rösttext som NULL. De andra alternativen returneras som NULL med konfidenspoängen noll (0) och rösttext som NULL.

Not

Alla taligenkänningsmotorer kan inte returnera alla värden för alla parametrar för den här händelsen. Kontakta motorleverantören för att avgöra om motorn stöder Microsoft Speech API-gränssnittet för att returnera alternativ och konfidenspoäng.

 

Se även

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