KSPROPERTY_SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_PATTERNS 속성은 검색할 키워드를 구성하기 위해 운영 체제에서 설정합니다.

OS는 키워드(keyword) 패턴을 설정하거나 이를 빈 값으로 설정할 수 있습니다.

OS에서 이 속성을 설정하면 드라이버가 이전에 무장한 경우 감지기를 자동으로 무장 해제합니다.

드라이버가 리소스 부족으로 인해 "set" 요청을 충족할 수 없는 경우 드라이버는 STATUS_INSUFFICIENT_RESOURCES 요청을 실패합니다.

사용 요약 테이블 - KSPROPSETID_SoundDetector

이 사용 현황 표에는 KSPROPSETID_SoundDetector KSPROPERTY_SOUNDDETECTOR_ARMED 호출되는 시기가 요약되어 있습니다.

가져오기 설정 대상 속성 설명자 형식 속성 값 형식

아니요

필터

KSPROPERTY

KSMULTIPLE_ITEM

사용 요약 테이블 - KSPROPSETID_SoundDetector2

이 사용 현황 표에는 KSPROPERTY_SOUNDDETECTOR_ARMED 호출되는 시기가 요약되어 KSPROPSETID_SoundDetector2

가져오기 설정 대상 속성 설명자 형식 속성 값 형식

아니요

필터

KSSOUNDDETECTORPROPERTY

KSMULTIPLE_ITEM

반환 값

속성 값은 KSMULTIPLE_ITEM 구조와 64비트 정렬 검색 패턴의 시퀀스입니다. 각 패턴은 SOUNDDETECTOR_PATTERNHEADER 패턴 페이로드로 시작합니다.

설명

드라이버는 다음까지 "set" 요청을 완료하지 않습니다.

  • 탐지기는 무장 해제되고 KSPROPERTY_SOUNDDETECTOR_ARMED 대한 후속 "get" 요청은 false를 반환합니다.
  • KSPROPERTY_SOUNDDETECTOR_MATCHRESULT 대한 후속 "get" 요청은 데이터를 반환하지 않습니다.
  • 새로운 키워드(keyword) 패턴이 설정되고 키워드(keyword) 탐지기가 새 패턴에서 작동합니다.

드라이버는 위의 조건이 충족될 때까지 요청을 보류 상태로 유지할 수 있습니다. 또한 디바이스에 측정 가능한 초기화 시간이 필요한 경우 드라이버는 디바이스가 준비되고 에서 요청을 처리할 수 있을 때까지 이 요청을 보류 상태로 유지할 수 있습니다.

OS에서는 검색된 키워드(keyword) 및 키워드(keyword) 패턴 업데이트(예: 키워드(keyword) 검색되고 OS가 키워드를 업데이트하기 전에 KSEVENT_SOUNDDETECTOR 즉시 생성된 경우) 간의 경합 상태를 방지하기 위해 이 동작이 필요합니다.

OS는 이 요청이 완료되기까지 2초 이상 기다립니다.

요구 사항

지원되는 최소 클라이언트

Windows 10

지원되는 최소 서버

Windows Server 2016

헤더

Ksmedia.h

참고 항목

SOUNDDETECTOR_PATTERNHEADER

SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_ARMED

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

KSPROPERTY

KSMULTIPLE_ITEM