Metodo IKeywordDetectorOemAdapter::P arseDetectionResultData (keyworddetectoroepter.h)

Articolo
07/27/2023

Il metodo ParseDetectionResultData viene chiamato dal sistema operativo dopo aver gestito un evento di rilevamento delle parole chiave e dopo aver recuperato i dati dei risultati da KSPROPERTY_SOUNDDETECTOR_MATCHRESULT. Il sistema operativo passa i dati dei risultati di corrispondenza specifici dell'OEM a questo metodo per ottenere i risultati di un rilevamento delle parole chiave. OEMDLL elabora i risultati e restituisce informazioni sulla parola chiave corrispondente, sulla lingua associata alla parola chiave corrispondente e sull'utente corrispondente (se presente).

Sintassi

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

Parametri

[in] UserModelData

Puntatore a IStream associato ai dati del modello per il modello di arming.

[in] Result

Puntatore alla SOUNDDETECTOR_PATTERNHEADER dall'DDI.

[out] KeywordId

Identifica una funzione parola chiave. Il driver può restituire 0 per indicare nessuna corrispondenza.

[out] LangId

Identifica una lingua.

[out] pIsUserMatch

Indica se l'utente corrisponde.

[out] KeywordStartPerformanceCounterValue

Facoltativamente, restituisce l'ora di inizio della parola chiave in termini di contatore delle prestazioni di Windows. L'OEMDLL deve restituire 0 se non è disponibile.

[out] KeywordEndPerformanceCounterValue

Facoltativamente, restituisce l'ora di fine della parola chiave in termini di contatore delle prestazioni di Windows. L'OEMDLL deve restituire 0 se non è disponibile.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore restituito	Descrizione
S_OK	La funzione è stata chiusa correttamente.
E_POINTER	Il puntatore ModelData è NULL.
E_INVALIDARG	I parametri KeywordId o LangId non sono validi.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)	Impossibile completare l'elaborazione.
E_HW_RESET	Reimpostazione hardware a causa di un errore interno.

Commenti

Se il driver include una parte della parola chiave parlata nel flusso di parole chiave/comando burst dal pin del rilevatore di parole chiave, il driver deve restituire un valore valido per KeywordEndTime. In caso contrario, il driver può restituire facoltativamente 0.

Se il driver restituisce KeywordStartTime o KeywordEndTime, i valori restituiti devono essere coerenti con i timestamp restituiti dalla routine IMiniportWaveRTInputStream::GetReadPacket .

Il driver può restituire valori validi per KeywordStartTime e KeywordEndTime , indipendentemente dal fatto che il driver includa qualsiasi parte della parola chiave parlata nel flusso di parole chiave/comando burst.

Se il chiamante riceve E_HW_RESET, nessuna parola chiave è stata rilevata dall'hardware e lo stato è stato perso. Un braccio di nuovo sarà necessario per tornare a uno stato di monitoraggio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	keyworddetectoroemadapter.h

Vedi anche

Cotaskmemalloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER

Condividi tramite