IAgentUserInput::GetAllItemData

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do 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
);

Recupera os dados de todas as alternativas dede comandopassadas para um retorno de chamada IAgentNotifySink::Command.

• Retorna S_OK para indicar que a operação foi bem-sucedida.

pdwItemIndices

Endereço de uma variável que recebe as IDs de Comandos passado para o retorno de chamada IAgentNotifySink::Command.

plConfidences

Endereço de uma variável que recebe as pontuações de confiança para alternativas de de comando passadas para o retorno de chamada IAgentNotifySink::Command.

pbszText

Endereço de uma variável que recebe o texto de voz para alternativas de de comando passadas para o retorno de chamadaIAgentNotifySink::Command.

Se a entrada de fala acionar IAgentNotifySink::Command, o servidor retornará a melhor correspondência, a segunda melhor correspondência e a terceira melhor correspondência, se estas forem fornecidas pelo mecanismo de fala. Ele fornece os escores de confiança relativa, na faixa de -100 a 100, e o texto real "ouvido" pelo mecanismo de fala. Se a melhor correspondência foi um comando fornecido pelo servidor, o servidor envia uma ID NULL, mas ainda envia uma pontuação de confiança e o Voice texto.

Se a entrada de fala não foi a fonte para o evento; por exemplo, se o usuário selecionou o comando no menu pop-up do caractere, o servidor do Microsoft Agent retornará a ID dode comandoselecionado, com uma pontuação de confiança de 100 e texto de voz como NULL. As outras alternativas retornam como NULL com escores de confiança de zero (0) e texto de voz como NULL.

Ver também

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