IKeywordDetectorOemAdapter::P arseDetectionResultData-Methode (keyworddetectoroemadapter.h)

Die ParseDetectionResultData-Methode wird vom Betriebssystem aufgerufen, nachdem ein Schlüsselwort (keyword) Erkennungsereignis behandelt wurde und die Ergebnisdaten aus KSPROPERTY_SOUNDDETECTOR_MATCHRESULT abgerufen wurden. Das Betriebssystem übergibt die OEM-spezifischen Übereinstimmungsergebnisdaten an diese Methode, um die Ergebnisse einer Schlüsselwort (keyword) Erkennung abzurufen. Die OEMDLL verarbeitet die Ergebnisse und gibt Informationen über die übereinstimmenden Schlüsselwort (keyword), die Sprache, die dem übereinstimmenden Schlüsselwort (keyword) zugeordnet ist, und den übereinstimmenden Benutzer (falls vorhanden) zurück.

Syntax

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

Parameter

[in] UserModelData

Ein Zeiger auf IStream , der an Modelldaten für das Armingmuster gebunden ist.

[in] Result

Ein Zeiger auf den SOUNDDETECTOR_PATTERNHEADER aus dem DDI.

[out] KeywordId

Gibt eine Schlüsselwort (keyword)-Funktion an. Der Treiber gibt möglicherweise 0 zurück, um keine Übereinstimmung anzugeben.

[out] LangId

Identifiziert eine Sprache.

[out] pIsUserMatch

Gibt an, ob der Benutzer übereinstimmt.

[out] KeywordStartPerformanceCounterValue

Gibt optional die Startzeit des Schlüsselwort (keyword) in Bezug auf den Windows-Leistungsindikator zurück. Die OEMDLL sollte 0 zurückgeben, wenn dies nicht verfügbar ist.

[out] KeywordEndPerformanceCounterValue

Gibt optional die Endzeit des Schlüsselwort (keyword) in Bezug auf den Windows-Leistungsindikator zurück. Die OEMDLL sollte 0 zurückgeben, wenn dies nicht verfügbar ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert BESCHREIBUNG
S_OK
Die Funktion wurde erfolgreich beendet.
E_POINTER
Der ModelData-Zeiger ist NULL.
E_INVALIDARG
Die Parameter KeywordId oder LangId sind ungültig.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)
Die Verarbeitung konnte nicht abgeschlossen werden.
E_HW_RESET
Die Hardware wurde aufgrund eines internen Fehlers zurückgesetzt.

Hinweise

Wenn der Treiber einen Teil der gesprochenen Schlüsselwort (keyword) in den Burst-Schlüsselwort (keyword)/Befehlsdatenstrom von seinem Schlüsselwort (keyword)-Detektor-Pin enthält, muss der Treiber einen gültigen Wert für KeywordEndTime zurückgeben. Andernfalls kann der Treiber optional 0 zurückgeben.

Wenn der Treiber KeywordStartTime oder KeywordEndTime zurückgibt, müssen die zurückgegebenen Werte mit den Zeitstempeln übereinstimmen, die von der IMiniportWaveRTInputStream::GetReadPacket-Routine des Treibers zurückgegeben werden.

Der Treiber kann gültige Werte für KeywordStartTime und KeywordEndTime zurückgeben, unabhängig davon, ob der Treiber einen Teil der gesprochenen Schlüsselwort (keyword) im Burst-Schlüsselwort (keyword)/Befehlsstream enthält.

Wenn der Aufrufer E_HW_RESET empfängt, wurde kein Schlüsselwort (keyword) von der Hardware erkannt, und der Zustand ging verloren. Ein erneutes Ausrüsten ist erforderlich, um in einen Überwachungszustand zurückzukehren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile keyworddetectoroemadapter.h

Weitere Informationen

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER