[從 Windows 7 開始,Microsoft Agent 已被取代,而且在後續版本的 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
);
擷取傳遞至IAgentNotifySink::Command 回呼之所有命令替代專案的資料。
- 傳回S_OK,表示作業成功。
-
pdwItemIndices
-
接收傳遞至IAgentNotifySink::Command回呼之命令識別碼的變數位址。
-
plConfidences
-
接收傳遞至IAgentNotifySink::Command回呼之命令替代專案信賴分數的變數位址。
-
pbszText
-
接收傳遞至IAgentNotifySink::Command回呼之命令替代專案的語音文字的變數位址。
如果語音輸入觸發 IAgentNotifySink::Command,則伺服器會傳回最佳比對、第二個最符合專案,以及語音引擎所提供的第三個最佳比對。 它提供相對信賴分數,範圍介於 -100 到 100,語音引擎會「聽到」實際文字。 如果最符合的是伺服器提供的命令,伺服器會傳送 Null 識別碼,但仍會傳送信賴分數和 語音 文字。
如果語音輸入不是事件的來源;例如,如果使用者從字元的快顯功能表選取命令,則 Microsoft Agent 伺服器會傳 回所選取 命令的識別碼,信賴分數為 100,且語音文字為 Null。 其他替代方案會以 Null 傳回,信賴分數為 0 (0) ,而語音文字則傳回為 Null。
注意
並非所有語音辨識引擎都可能會傳回此事件所有參數的所有值。 請洽詢您的引擎廠商,以判斷引擎是否支援 Microsoft 語音 API 介面來傳回替代專案和信賴分數。
另請參閱
IAgentUserInput::GetItemConfidence、 IAgentUserInput::GetItemText、 IAgentUserInput::GetItemID