IAgentUserInput::GetAllItemData
[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de 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
);
Récupère les données pour toutes les autres commandes passées à un rappel IAgentNotifySink :: Command .
- Retourne _ la valeur S OK pour indiquer que l’opération a réussi.
-
pdwItemIndices
-
Adresse d’une variable qui reçoit les ID des commandes passées au rappel IAgentNotifySink :: Command .
-
plConfidences
-
Adresse d’une variable qui reçoit les scores de confiance pour les alternatives de commande transmises au rappel IAgentNotifySink :: Command .
-
pbszText
-
Adresse d’une variable qui reçoit le texte vocal pour les commandes alternatives transmises au rappel IAgentNotifySink :: Command .
Si l’entrée vocale déclenche IAgentNotifySink :: Command, le serveur renvoie la meilleure correspondance, la deuxième-meilleure correspondance et la troisième, si elles sont fournies par le moteur de reconnaissance vocale. Il fournit les scores de confiance relatifs, dans la plage comprise entre-100 et 100, et le texte réel « entendu » par le moteur de reconnaissance vocale. Si la meilleure correspondance était une commande fournie par le serveur, le serveur envoie un ID NULL, mais envoie toujours un score de confiance et le texte vocal .
Si l’entrée vocale n’est pas la source de l’événement ; par exemple, si l’utilisateur a sélectionné la commande dans le menu contextuel du caractère, le serveur Microsoft Agent renvoie l’ID de la commande sélectionnée, avec un score de confiance de 100 et un texte vocal comme null. Les autres alternatives retournent comme NULL avec des scores de confiance de zéro (0) et un texte vocal comme NULL.
Notes
Tous les moteurs de reconnaissance vocale ne peuvent pas retourner toutes les valeurs de tous les paramètres de cet événement. Contactez votre fournisseur de moteur pour déterminer si le moteur prend en charge l’interface de l’API Microsoft Speech pour retourner des alternatives et des scores de confiance.
Voir aussi
IAgentUserInput :: GetItemConfidence, IAgentUserInput :: GetItemText, IAgentUserInput :: getItemID