KSPROPERTY_JACK_DESCRIPTION3

아티클
06/15/2023

KSPROPERTY_JACK_DESCRIPTION3 속성은 필터 핸들을 사용하여 액세스하는 핀 단위 속성으로 구현됩니다.

버전 22H2 이상 Windows 운영 체제에서 연결된 KSJACK_DESCRIPTION3 구조를 사용하여 잭의 현재 구성을 지정하고 변경할 수 있습니다.

사용 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
Yes	아니요	핀 팩터리(필터 핸들을 통해)	KSP_PIN	KSMULTIPLE_ITEM 뒤에 KSJACK_DESCRIPTION3 구조체 배열

속성 값(instance 데이터)은 KSMULTIPLE_ITEM 뒤에 KSJACK_DESCRIPTION3 구조의 배열입니다.

반환 값

KSPROPERTY_JACK_DESCRIPTION3 속성 요청은 KSMULTIPLE_ITEM 반환한 다음 N KSJACK_DESCRIPTION3 구조체 배열을 반환합니다. 여기서 N = 지정된 브리지 핀과 연결된 잭의 수입니다. 다음 목록에서는 속성 요청에 의해 반환되는 항목을 보여 집니다.

KSMULTIPLE_ITEM. Size = sizeof(KSMULTIPLE_ITEM) + N * sizeof(KSJACK_DESCRIPTION3)

KSMULTIPLE_ITEM. Count = N

KSJACK_DESCRIPTION3[0]

...

KSJACK_DESCRIPTION3[N-1]

설명

KSJACK_DESCRIPTION3 및 KSPROPERTY_JACK_DESCRIPTION3 사용하여 오디오 디바이스 변경 내용 전달

Windows 오디오 시스템은 오디오 엔드포인트를 만드는 동안 오디오 디바이스 기능을 캐시합니다. 이러한 캐시된 값은 HW 오디오 엔진의 존재, 형식 지원, 컨테이너 ID, 버퍼 크기 특성 등의 기능을 위한 것입니다. 이러한 캐시된 값은 Windows 설치 수명 동안 유지됩니다. 오디오 드라이버가 업데이트되거나 OS 업그레이드 중에만 새로 고쳐집니다.

KSJACK_DESCRIPTION3 통해 Windows 오디오 시스템은 오디오 드라이버가 캐시된 모든 값을 삭제하고 새로 고치도록 요청하는 메커니즘을 제공합니다. 리소스 제약 조건과 같은 오디오 디바이스 기능의 변경으로 요청을 트리거할 수 있습니다.

드라이버가 런타임에 KSJACK_DESCRIPTION3 콘텐츠를 변경할 때마다 드라이버는 기존 KSEVENT_PINCAPS_JACKINFOCHANGE 이벤트를 트리거합니다.

Windows 오디오 시스템은 오디오 엔드포인트에 캐시된 마지막으로 보고된 ConfigId 값을 유지 관리합니다. ConfigId 값은 KSEVENT_PINCAPS_JACKINFOCHANGE 이벤트에 대한 응답과 시스템 부팅 시 오디오 엔드포인트를 정상적으로 처리하는 동안 오디오 엔드포인트 작성기 서비스 다시 시작, 오디오 드라이버 업데이트 또는 엔드포인트에 대한 인터페이스 상태 변경으로 검색됩니다.

검색된 ConfigId 값이 이전에 저장된 값과 다른 경우 Windows 오디오 시스템은 이전에 캐시된 모든 엔드포인트 기능을 삭제하고 새로 고칩니다.

권장되는 사용법은 ConfigId (비트 마스크 또는 열거형) 값으로 제어되는 드라이버 내에서 여러 오디오 엔드포인트 구성을 정의하는 것입니다. 예를 들어 ConfigId 가 1이면 오디오 엔진 노드가 있음을 나타낼 수 있지만 ConfigId 2는 오디오 엔진 노드를 보고하지 않습니다. 드라이버에서 사용 중인 ConfigId 는 KSPROPERTY_JACK_DESCRIPTION3 통해 Windows 오디오 시스템과 공유되며 Windows 오디오 시스템에서 캐시된 기능과 엔드포인트를 동기화하는 역할을 합니다.

ConfigId의 값은 Windows에 불투명합니다. 오디오 드라이버는 위에서 설명한 대로 비트 마스크 또는 열거형 대신 런타임에 선택한 타임스탬프 또는 증가 값을 사용할 수 있습니다. 이 전략은 엔드포인트 기능이 변경되지 않은 경우에도 부팅 중에 불필요한 엔드포인트를 새로 고치거나 인터페이스를 변경하여 마지막으로 저장된 ConfigId 값을 새로 보고된 값과 동기화할 수 있기 때문에 권장되지 않습니다. 또한 이 방법을 사용하면 드라이버와 Windows의 동기화가 중단되어 오디오 재생에 실패할 가능성이 높아질 수 있습니다.

ConfigId 변경 시 엔드포인트에서 캐시된 값을 새로 고치는 데 사용되는 메커니즘은 운영 체제 업그레이드 및 드라이버 업데이트 사용되는 메커니즘과 동일합니다. 엔드포인트에 대한 새 ConfigId 설정과 일치하는 새로 고친 캐시된 값을 포함하는 다른 ID를 가진 새 엔드포인트가 만들어지고, 사용자 설정이 이전 엔드포인트에서 새 엔드포인트로 복사되고, 마지막으로 이전 엔드포인트가 삭제됩니다. OS 업그레이드의 오디오 엔드포인트 마이그레이션 프로세스에 대한 자세한 내용은 운영 체제 업그레이드를 참조하세요.