Méthode IKeywordDetectorOemAdapter ::P arseDetectionResultData (keyworddetectoroemadapter.h)

Article
07/27/2023

La méthode ParseDetectionResultData est appelée par le système d’exploitation après avoir géré un événement de détection de mot clé et après avoir récupéré les données de résultat de KSPROPERTY_SOUNDDETECTOR_MATCHRESULT. Le système d’exploitation transmet les données de résultat de correspondance spécifiques à l’OEM à cette méthode afin d’obtenir les résultats d’une détection mot clé. OEMDLL traite les résultats et retourne des informations sur le mot clé mis en correspondance, la langue associée au mot clé mis en correspondance et l’utilisateur correspondant (le cas échéant).

Syntaxe

HRESULT ParseDetectionResultData(
  [in]  IStream                     *UserModelData,
  [in]  SOUNDDETECTOR_PATTERNHEADER *Result,
  [out] KEYWORDID                   *KeywordId,
  [out] LANGID                      *LangId,
  [out] BOOL                        *pIsUserMatch,
  [out] ULONG64                     *KeywordStartPerformanceCounterValue,
  [out] ULONG64                     *KeywordEndPerformanceCounterValue
);

Paramètres

[in] UserModelData

Pointeur vers IStream lié aux données du modèle d’armage.

[in] Result

Pointeur vers le SOUNDDETECTOR_PATTERNHEADER à partir de la DDI.

[out] KeywordId

Identifie une fonction mot clé. Le pilote peut retourner 0 pour indiquer aucune correspondance.

[out] LangId

Identifie une langue.

[out] pIsUserMatch

Indique si l’utilisateur correspond.

[out] KeywordStartPerformanceCounterValue

Retourne éventuellement l’heure de début du mot clé en termes de compteur de performances Windows. L’OEMDLL doit retourner 0 si ce n’est pas disponible.

[out] KeywordEndPerformanceCounterValue

Retourne éventuellement l’heure de fin du mot clé en termes de compteur de performances Windows. L’OEMDLL doit retourner 0 si ce n’est pas disponible.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur retournée	Description
S_OK	La fonction s’est terminée avec succès.
E_POINTER	Le pointeur ModelData a la valeur NULL.
E_INVALIDARG	Les paramètres KeywordId ou LangId ne sont pas valides.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)	Le traitement n’a pas pu se terminer.
E_HW_RESET	Réinitialisation matérielle en raison d’une erreur interne.

Remarques

Si le pilote inclut une partie du mot clé parlé dans le flux de mot clé/commande de rafale à partir de sa broche de détecteur de mot clé, le pilote doit retourner une valeur valide pour KeywordEndTime. Sinon, le pilote peut éventuellement retourner 0.

Si le pilote retourne KeywordStartTime ou KeywordEndTime, les valeurs retournées doivent être cohérentes avec les horodatages retournés par la routine IMiniportWaveRTInputStream ::GetReadPacket du pilote.

Le pilote peut retourner des valeurs valides pour KeywordStartTime et KeywordEndTime, que le pilote inclue ou non une partie de la mot clé parlée dans le flux de mot clé/commande de rafale.

Si l’appelant reçoit E_HW_RESET, aucun mot clé n’a été détecté par le matériel et l’état a été perdu. Un ré armoir sera nécessaire pour revenir à un état de surveillance.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	keyworddetectoroemadapter.h

Voir aussi

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream ::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER

Partager via