KSPROPERTY_SOUNDDETECTOR_PATTERNS
Свойство KSPROPERTY_SOUNDDETECTOR_PATTERNS задается операционной системой для настройки обнаруженных ключевых слов.
ОС задает ключевое слово шаблонов или может задать для этого значения пустое значение.
Когда ОС задает это свойство, драйвер автоматически разоружает детектор, если он был ранее вооружена.
Если драйвер не может удовлетворить запрос set из-за нехватки ресурсов, драйвер завершает запрос с STATUS_INSUFFICIENT_RESOURCES.
Сводная таблица использования — KSPROPSETID_SoundDetector
В этой таблице использования приводится сводка при вызове KSPROPERTY_SOUNDDETECTOR_ARMED с помощью KSPROPSETID_SoundDetector
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Нет |
Да |
Фильтр |
Сводная таблица использования — KSPROPSETID_SoundDetector2
В этой таблице использования приводится сводка при вызове KSPROPERTY_SOUNDDETECTOR_ARMED с помощью KSPROPSETID_SoundDetector2
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Нет |
Да |
Фильтр |
Возвращаемое значение
Значение свойства представляет собой 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 |
См. также
KSPROPERTY_SOUNDDETECTOR_ARMED