Метод IKeywordDetectorOemAdapter::P arseDetectionResultData (keyworddetectoroemadapter.h)

Статья
2025-04-09

Метод ParseDetectionResultData вызывается операционной системой после обработки события обнаружения ключевых слов и после получения данных результатов из KSPROPERTY_SOUNDDETECTOR_MATCHRESULT. Операционная система передает в этот метод данные результатов для конкретного изготовителя оборудования, чтобы получить результаты обнаружения ключевых слов. OEMDLL обрабатывает результаты и возвращает сведения о соответствующем ключевом слове, языке, связанном с соответствующим ключевым словом, и соответствующим пользователем (при наличии).

Синтаксис

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

Параметры

[in] UserModelData

Указатель на IStream , привязанный к данным модели для шаблона руки.

[in] Result

Указатель на SOUNDDETECTOR_PATTERNHEADER из DDI.

[out] KeywordId

Определяет функцию ключевого слова. Драйвер может вернуть значение 0, чтобы указать, что совпадения не совпадают.

[out] LangId

Определяет язык.

[out] pIsUserMatch

Указывает, соответствует ли пользователь.

[out] KeywordStartPerformanceCounterValue

При необходимости возвращает время начала ключевого слова с точки зрения счетчика производительности Windows. OEMDLL должен возвращать значение 0, если это недоступно.

[out] KeywordEndPerformanceCounterValue

При необходимости возвращает время окончания ключевого слова с точки зрения счетчика производительности Windows. OEMDLL должен возвращать значение 0, если это недоступно.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемое значение	Описание
S_OK	Функция завершилась успешно.
E_POINTER	Указатель ModelData равен NULL.
E_INVALIDARG	Недопустимые параметры KeywordId или LangId .
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)	Обработка не смогла завершиться.
E_HW_RESET	Сброс оборудования из-за внутренней ошибки.

Замечания

Если драйвер включает в себя любую часть произнесемого ключевого слова в потоке с помощью ключевого слова или команды из пин-кода детектора ключевых слов, драйвер должен вернуть допустимое значение для KeywordEndTime. В противном случае драйвер может возвращать значение 0.

Если драйвер возвращает KeywordStartTime или KeywordEndTime, возвращаемые значения должны быть согласованы с метками времени, возвращаемыми из подпрограммы IMiniportWaveRTInputStream::GetReadPacket .

Драйвер может возвращать допустимые значения для KeywordStartTime и KeywordEndTime независимо от того, включает ли драйвер любую часть произнесемого ключевого слова в потоке быстрого или командного слова.

Если вызывающий объект получает E_HW_RESET, ключевое слово не было обнаружено оборудованием и состояние было потеряно. Для возврата к состоянию мониторинга потребуется повторная рука.

Требования

Требование	Ценность
Минимально поддерживаемый клиент	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
Заголовок	keyworddetectoroemadapter.h