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

KSPROPSETID_SoundDetector2

  • Статья

Набор KSPROPSETID_SoundDetector2 свойств содержит свойства, используемые для регистрации фильтра для устройства захвата звука, которое также поддерживает детектор. Фильтр имеет фабрику контактов KS с категорией контактов KSNODETYPE_AUDIO_KEYWORDDETECTOR. В данном экземпляре фильтра KS не может быть более одной фабрики контактов с этой категорией контактов KS.

KSPROPSETID_SoundDetector2поддерживается в Windows 10 версии 1903 и более поздних. Набор свойств KSPROPSETID_SoundDetector2 используется для поддержки нескольких голосовых агентов. Дополнительные сведения см. в разделе Несколько голосовых помощников. KSPROPSETID_SoundDetector набор свойств используется в системах, поддерживающих только Кортану.

KSPROPSETID_SoundDetector2 использует структуру KSSOUNDDETECTORPROPERTY вместо KSPROPERTY:

typedef struct {
    KSPROPERTY  Property;
    GUID        EventId;
} KSSOUNDDETECTORPROPERTY, *PKSSOUNDDETECTORPROPERTY;

Все KSPROPSETID_SoundDetector2 свойства вызываются со структурой данных KSSOUNDDETECTORPROPERTY . Эта структура данных содержит 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.