Condividi tramite


IAgentUserInput::GetAllItemData

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di 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 i dati per tutte le alternative command passate a un callback IAgentNotifySink::Command.

  • Restituisce S_OK per indicare che l'operazione è stata completata correttamente.

pdwItemIndices

Indirizzo di una variabile che riceve gli ID dei comandi passati al callback IAgentNotifySink::Command.

plConfidences

Indirizzo di una variabile che riceve i punteggi di attendibilità per comandi alternative passate al callback IAgentNotifySink::Command.

pbszText

Indirizzo di una variabile che riceve il testo vocale per comandi alternative passate al callback IAgentNotifySink::Command.

Se l'input vocale viene attivato IAgentNotifySink::Command, il server restituisce la corrispondenza migliore, la corrispondenza migliore e la terza corrispondenza migliore, se vengono fornite dal motore di riconoscimento vocale. Fornisce i punteggi di attendibilità relativi, nell'intervallo tra -100 e 100 e il testo effettivo "sentito" dal motore di riconoscimento vocale. Se la corrispondenza migliore è un comando fornito dal server, il server invia un ID NULL, ma invia comunque un punteggio di attendibilità e il testo Voice.

Se l'input vocale non è l'origine per l'evento; Ad esempio, se l'utente ha selezionato il comando dal menu a comparsa del carattere, il server di Microsoft Agent restituisce l'ID del comando selezionato, con un punteggio di attendibilità pari a 100 e testo vocale come NULL. Le altre alternative restituiscono null con punteggi di attendibilità pari a zero (0) e testo vocale come NULL.

Nota

Non tutti i motori di riconoscimento vocale possono restituire tutti i valori per tutti i parametri di questo evento. Rivolgersi al fornitore del motore per determinare se il motore supporta l'interfaccia dell'API Riconoscimento vocale Microsoft per restituire alternative e punteggi di attendibilità.

 

Vedere anche

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