KSPROPSETID_SoundDetector2

속성 집합에는 KSPROPSETID_SoundDetector2 감지기를 지원하는 오디오 캡처 디바이스에 대한 필터를 등록하는 데 사용되는 속성이 포함되어 있습니다. 필터에는 핀 범주 KSNODETYPE_AUDIO_KEYWORDDETECTOR 있는 KS 핀 팩터리가 있습니다. 지정된 KS 필터 instance 이 KS 핀 범주가 있는 핀 팩터리는 둘 이상 있을 수 없습니다.

KSPROPSETID_SoundDetector2는 Windows 10 버전 1903 이상에서 지원됩니다. KSPROPSETID_SoundDetector2 속성 집합은 여러 음성 에이전트를 지원하는 데 사용됩니다. 자세한 내용은 다중 음성 도우미를 참조하세요. KSPROPSETID_SoundDetector 속성 집합은 Cortana만 지원하는 시스템에서 사용됩니다.

KSPROPSETID_SoundDetector2 에서는 KSPROPERTY 대신 KSSOUNDDETECTORPROPERTY 구조를 사용합니다.

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

모든 KSPROPSETID_SoundDetector2 속성은 KSSOUNDDETECTORPROPERTY 데이터 구조로 호출됩니다. 이 데이터 구조에는 무장, 다시 설정, 검색 등 키워드(keyword) 대한 KSPROPERTY 및 이벤트 ID가 포함됩니다.

헤더 파일은 다음과 같이 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 필터는 이 읽기/쓰기 속성을 지원합니다. OS는 검색할 키워드를 구성하도록 이 속성을 설정합니다.

• KSPROPERTY_SOUNDDETECTOR_ARMED - 이 읽기/쓰기 속성은 탐지기가 무장되어 있는지 여부를 나타내는 단순한 부울 상태. OS는 이를 설정하여 키워드(keyword) 탐지기를 연결합니다. OS는 이를 해제하여 해제할 수 있습니다. 드라이버는 키워드(keyword) 패턴이 설정되고 키워드(keyword) 검색된 후에도 자동으로 이를 지웁니다. (OS는 다시 정렬해야 합니다.)

• KSPROPERTY_SOUNDDETECTOR_RESET - 패턴이 설정되지 않은 상태에서 탐지기를 비무장 상태로 다시 설정합니다.

• KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT - 음성 설정 탐지기에만 나중에 사용합니다. 속성이 지원되지 않거나 성공하지 못했음을 나타내는 이 요청에 실패하고 다른 모든 드라이버에 대해 true를 반환합니다.

키워드(keyword) 검색 시 KSNOTIFICATIONID_SoundDetector 포함하는 PNP 알림이 전송됩니다. 참고: 이는 KSEvent가 아니라 IoReportTargetDeviceChangeAsynchronous를 통해 페이로드와 함께 전송되는 PNP 이벤트입니다.