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