Método IKeywordDetectorOemAdapter::P arseDetectionResultData (keyworddetectoroemadapter.h)
O método ParseDetectionResultData é chamado pelo sistema operacional depois de manipular um evento de detecção de palavra-chave e depois de recuperar os dados resultantes de KSPROPERTY_SOUNDDETECTOR_MATCHRESULT. O sistema operacional passa os dados de resultado de correspondência específicos do OEM para esse método para obter os resultados de uma detecção de palavra-chave. O OEMDLL processa os resultados e retorna informações sobre o palavra-chave correspondente, o idioma associado ao palavra-chave correspondente e o usuário correspondente (se houver).
Sintaxe
HRESULT ParseDetectionResultData(
[in] IStream *UserModelData,
[in] SOUNDDETECTOR_PATTERNHEADER *Result,
[out] KEYWORDID *KeywordId,
[out] LANGID *LangId,
[out] BOOL *pIsUserMatch,
[out] ULONG64 *KeywordStartPerformanceCounterValue,
[out] ULONG64 *KeywordEndPerformanceCounterValue
);
Parâmetros
[in] UserModelData
Um ponteiro para IStream associado a dados de modelo para o padrão de arming.
[in] Result
Um ponteiro para o SOUNDDETECTOR_PATTERNHEADER da DDI.
[out] KeywordId
Identifica uma função palavra-chave. O driver pode retornar 0 para indicar que não há correspondência.
[out] LangId
Identifica um idioma.
[out] pIsUserMatch
Indica se o usuário correspondeu.
[out] KeywordStartPerformanceCounterValue
Opcionalmente, retorna a hora de início do palavra-chave em termos do contador de desempenho do Windows. O OEMDLL deverá retornar 0 se isso não estiver disponível.
[out] KeywordEndPerformanceCounterValue
Opcionalmente, retorna a hora de término do palavra-chave em termos do contador de desempenho do Windows. O OEMDLL deverá retornar 0 se isso não estiver disponível.
Retornar valor
Esse método pode retornar um desses valores.
Valor retornado | Descrição |
---|---|
|
A função foi encerrada com êxito. |
|
O ponteiro ModelData é NULL. |
|
Os parâmetros KeywordId ou LangId são inválidos. |
|
O processamento não pôde ser concluído. |
|
A redefinição de hardware devido a uma falha interna. |
Comentários
Se o driver incluir qualquer parte do palavra-chave falado no fluxo de palavra-chave/comando de intermitência do pino do detector de palavra-chave, o driver deverá retornar um valor válido para KeywordEndTime. Caso contrário, o driver poderá retornar opcionalmente 0.
Se o driver retornar KeywordStartTime ou KeywordEndTime, os valores retornados deverão ser consistentes com os carimbos de data/hora retornados da rotina IMiniportWaveRTInputStream::GetReadPacket do driver.
O driver pode retornar valores válidos para KeywordStartTime e KeywordEndTime, independentemente de o driver incluir qualquer parte do palavra-chave falado no fluxo de palavra-chave/comando de intermitência.
Se o chamador receber E_HW_RESET, nenhuma palavra-chave foi detectada pelo hardware e o estado foi perdido. Um novo braço será necessário para voltar a um estado de monitoramento.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 10 |
Servidor mínimo com suporte | Windows Server 2016 |
Plataforma de Destino | Windows |
Cabeçalho | keyworddetectoroemadapter.h |
Confira também
IMiniportWaveRTInputStream::GetReadPacket