Share via

IAgentUserInput::GetAllItemData

  • Статья

[Агент Майкрософт не рекомендуется использовать в 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 .

plConfidences

Адрес переменной, которая получает оценки достоверности для альтернативных команд , передаваемых обратному вызову IAgentNotifySink::Command .

pbszText

Адрес переменной, которая получает голосовый текст для альтернатив command , передаваемых обратному вызову IAgentNotifySink::Command .

Если речевой ввод активирует IAgentNotifySink::Command, сервер возвращает наилучшее соответствие, второе и третье лучшее соответствие, если они предоставляются подсистемой речи. Он предоставляет относительные оценки достоверности в диапазоне от -100 до 100 и фактический текст, "услышанный" модулем речи. Если лучшим совпадением была команда, предоставляемая сервером, сервер отправляет идентификатор NULL, но по-прежнему отправляет оценку достоверности и текст голосовой связи .

Если речевой ввод не был источником события; Например, если пользователь выбрал команду во всплывающем меню символа, сервер Microsoft Agent возвращает идентификатор выбранной команды с оценкой достоверности 100, а голосовый текст — значение NULL. Другие варианты возвращают значение NULL с оценкой достоверности ноль (0), а голосовый текст — значение NULL.

Примечание

Не все механизмы распознавания речи могут возвращать все значения для всех параметров этого события. Обратитесь к поставщику подсистемы, чтобы определить, поддерживает ли модуль интерфейс API распознавания речи (Майкрософт) для возврата альтернативных вариантов и оценки достоверности.

 

См. также:

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