IAgentUserInput::GetAllItemData

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas 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 alternativasde 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 passados para o retorno de chamada IAgentNotifySink::Command.

plConfidences

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

pbszText

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

Se a entrada de fala disparar IAgentNotifySink::Command, o servidor retornará a melhor correspondência, a segunda melhor correspondência e a terceira melhor correspondência, se elas forem fornecidas pelo mecanismo de fala. Ele fornece as pontuações relativas de confiança, no intervalo de -100 a 100, e o texto real "ouvido" pelo mecanismo de fala. Se a melhor correspondência for um comando fornecido pelo servidor, o servidor enviará uma ID NULL, mas ainda enviará uma pontuação de confiança e o texto Voice.

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

Consulte Também

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