IAgentUserInput：：GetAllItemData

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 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 回调的命令 ID 的变量的地址。

plConfidences

接收传递给 IAgentNotifySink：：Command 回调的命令替代项的置信度分数的变量的地址。

pbszText

接收传递给 IAgentNotifySink：：Command 回调的命令替代项的语音文本的变量的地址。

如果语音输入触发 IAgentNotifySink：：Command，则服务器将返回最佳匹配项、第二最佳匹配项和第三最佳匹配项（如果这些匹配项由语音引擎提供）。 它提供 -100 到 100 范围内的相对置信度分数，以及语音引擎“听到”的实际文本。 如果最佳匹配项是服务器提供的命令，则服务器发送 NULL ID，但仍发送置信度分数和 语音 文本。

如果语音输入不是事件的源;例如，如果用户从字符的弹出菜单中选择了命令，Microsoft 代理服务器将返回所选 命令 的 ID，置信度分数为 100，语音文本为 NULL。 其他替代项返回为 NULL，置信度分数为 0 (0) ，语音文本为 NULL。

注意

并非所有语音识别引擎都可以返回此事件的所有参数的所有值。 请与引擎供应商联系，以确定引擎是否支持 Microsoft 语音 API 接口来返回替代项和置信度分数。

 

另请参阅

IAgentUserInput：：GetItemConfidence、 IAgentUserInput：：GetItemText、 IAgentUserInput：：GetItemID