KSPROPSETID_SoundDetector2
Набор свойств KSPROPSETID_SoundDetector2 содержит свойства, которые используются для регистрации фильтра для устройства записи звука, который также поддерживает детектор. Фильтр имеет фабрику закреплений KS, которая имеет категорию контактов KSNODETYPE_AUDIO_KEYWORDDETECTOR. В данном экземпляре фильтра KS не может быть более одной фабрики закреплений.
KSPROPSETID_SoundDetector2 поддерживается в Windows 10 версии 1903 и более поздних версий. Набор свойств KSPROPSETID_SoundDetector2 используется для поддержки нескольких голосовых агентов. Дополнительные сведения см. в нескольких голосовых помощников.
KSPROPSETID_SoundDetector набор свойств используется в системах, поддерживающих только Кортана.
KSPROPSETID_SoundDetector2 использует структуру KSSOUNDDETECTORPROPERTY вместо KSPROPERTY:
typedef struct {
KSPROPERTY Property;
GUID EventId;
} KSSOUNDDETECTORPROPERTY, *PKSSOUNDDETECTORPROPERTY;
Все свойства KSPROPSETID_SoundDetector2 вызываются с структурой данных KSSOUNDDETECTORPROPER TY. Эта структура данных содержит идентификатор события KSPROPERTY и идентификатор события для ключевого слова, который необходимо вооружить, сбросить, обнаружить и т. д.
Файл заголовка определяет набор свойств KSPROPSETID_SoundDetector2 следующим образом:
#define STATIC_KSPROPSETID_SoundDetector2\
0xfe07e322, 0x450c, 0x4bd5, 0x84, 0xca, 0xa9, 0x48, 0x50, 0xe, 0xa6, 0xaa
DEFINE_GUIDSTRUCT("FE07E322-450C-4BD5-84CA-A948500EA6AA", KSPROPSETID_SoundDetector2);
Набор свойств KSPROPSETID_SoundDetector2 содержит следующие свойства:
KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS . Это свойство задается операционной системой для настройки ключевых слов, которые необходимо обнаружить.
KSPROPERTY_SOUNDDETECTOR_PATTERNS — фильтр KS драйвера поддерживает это свойство чтения и записи. ОС задает это свойство, чтобы настроить обнаруженные ключевые слова.
KSPROPERTY_SOUNDDETECTOR_ARMED — это свойство чтения и записи — это просто логическое состояние, указывающее, вооружен ли детектор. ОС задает это для привлечения детектора ключевых слов. ОС может очистить это, чтобы отключиться. Драйвер автоматически очищает это при установке шаблонов ключевых слов, а также после обнаружения ключевого слова. (ОС должна перезапуститься.)
KSPROPERTY_SOUNDDETECTOR_RESET. Сброс детектора в безоружное состояние без набора шаблонов.
KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT — будущее использование только для детекторов появления голоса. Сбой этого запроса, указывающий, что свойство не поддерживается или успешно, и возвращает значение true для всех остальных драйверов.
Во время обнаружения ключевых слов отправляется уведомление PNP, содержащее KSNOTIFICATIONID_SoundDetector. ПРИМЕЧАНИЕ. Это не KSEvent, а событие PNP, которое отправляется с полезными данными, через IoReportTargetDeviceChangeAsynchronous.