KSPROPERTY_SOUNDDETECTOR_PATTERNS

Статья
06/15/2023

Свойство 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 за которым следует полезные данные шаблона.

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

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

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

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

Требования

Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Заголовок	Ksmedia.h