Поделиться через


KSPROPERTY_SOUNDDETECTOR_PATTERNS

Свойство KSPROPERTY_SOUNDDETECTOR_PATTERNS задается операционной системой для настройки обнаруженных ключевых слов.

ОС задает ключевое слово шаблонов или может задать для этого значения пустое значение.

Когда ОС задает это свойство, драйвер автоматически разоружает детектор, если он был ранее вооружена.

Если драйвер не может удовлетворить запрос set из-за нехватки ресурсов, драйвер завершает запрос с STATUS_INSUFFICIENT_RESOURCES.

Сводная таблица использования — KSPROPSETID_SoundDetector

В этой таблице использования приводится сводка при вызове KSPROPERTY_SOUNDDETECTOR_ARMED с помощью KSPROPSETID_SoundDetector

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Нет

Да

Фильтр

KSPROPERTY

KSMULTIPLE_ITEM

Сводная таблица использования — KSPROPSETID_SoundDetector2

В этой таблице использования приводится сводка при вызове KSPROPERTY_SOUNDDETECTOR_ARMED с помощью KSPROPSETID_SoundDetector2

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Нет

Да

Фильтр

KSSOUNDDETECTORPROPERTY

KSMULTIPLE_ITEM

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

Значение свойства представляет собой KSMULTIPLE_ITEM структуру, за которой следует последовательность 64-разрядных шаблонов обнаружения. Каждый шаблон начинается с SOUNDDETECTOR_PATTERNHEADER за которым следует полезные данные шаблона.

Комментарии

Драйвер не должен выполнить запрос set, пока:

  • Детектор разоружается, и последующие запросы get на KSPROPERTY_SOUNDDETECTOR_ARMED возвращают значение false.
  • Последующие запросы get на KSPROPERTY_SOUNDDETECTOR_MATCHRESULT не возвращают никаких данных.
  • Новые шаблоны ключевое слово установлены, и детектор ключевое слово работает на новых шаблонах.

Драйвер может держать запрос в ожидании до тех пор, пока не будут выполнены указанные выше условия. Кроме того, если устройству требуется измеримое время инициализации, драйвер может держать этот запрос в ожидании до тех пор, пока устройство не будет готово, и сможет обработать запрос.

Операционной системе требуется такое поведение, чтобы избежать состояния гонки между обнаруженным ключевое слово и обновлением шаблонов ключевое слово (например, если обнаружена ключевое слово и KSEVENT_SOUNDDETECTOR создан мгновенно, прежде чем ОС обновит ключевые слова).

Ос ожидает выполнения этого запроса не менее 2 секунд.

Требования

Минимальная версия клиента

Windows 10

Минимальная версия сервера

Windows Server 2016

Заголовок

Ksmedia.h

См. также

SOUNDDETECTOR_PATTERNHEADER

SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_ARMED

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

KSPROPERTY

KSMULTIPLE_ITEM