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 a palavra-chave correspondente, o idioma associado à 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 de 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 da 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 da palavra-chave em termos do contador de desempenho do Windows. O OEMDLL deverá retornar 0 se isso não estiver disponível.
Valor de retorno
Esse método pode retornar um desses valores.
| Valor de retorno | 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. |
Observações
Se o driver incluir qualquer parte da palavra-chave falada na palavra-chave de intermitência/fluxo de comandos do pin do detector de palavras-chave, o driver deverá retornar um valor válido para keywordEndTime. Caso contrário, o driver poderá retornar 0 opcionalmente.
Se o driver retornar KeywordStartTime ou KeywordEndTime, os valores retornados deverão ser consistentes com os carimbos de data/hora retornados da rotina de IMiniportWaveRTInputStream do driver::GetReadPacket.
O driver pode retornar valores válidos para KeywordStartTime e keywordEndTime independentemente de o driver incluir qualquer parte da palavra-chave falada no fluxo de comando/palavra-chave de intermitência.
Se o chamador receber E_HW_RESET, nenhuma palavra-chave foi detectada pelo hardware e o estado foi perdido. Um re arm será necessário para voltar a um estado de monitoramento.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da Plataforma de Destino | Windows |
| cabeçalho | keyworddetectoroemadapter.h |
Consulte também
IMiniportWaveRTInputStream::GetReadPacket