비디오 캡처 미니드라이버 속성 집합

아티클
06/15/2023

이 섹션에서는 Microsoft Windows XP, Windows 2000 및 Windows 98/Me 이상 운영 체제에서 WDM 커널 스트리밍 서비스를 사용하는 비디오 캡처 미니드라이버에 사용할 수 있는 비디오 캡처 관련 속성 집합에 대해 설명합니다.

각 속성에 대한 참조 페이지에는 다음 열 머리글이 있는 테이블이 포함되어 있습니다.

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

이러한 제목에는 다음과 같은 의미가 있습니다.

가져오기

대상 KS 개체가 KSPROPERTY_TYPE_GET 속성 요청을 지원하나요?
설정

대상 KS 개체가 KSPROPERTY_TYPE_SET 속성 요청을 지원하나요?
대상

대상은 속성 요청이 전송되는 KS 개체입니다. 비디오 캡처 속성의 대상은 필터 또는 핀입니다. (속성 요청은 해당 커널 핸들로 대상 개체를 지정합니다.)
속성 설명자 형식

속성 설명자는 해당 속성에 대해 수행할 속성과 작업을 지정합니다. 설명자는 항상 KSPROPERTY 구조로 시작하지만 일부 형식의 설명자에는 추가 정보가 포함되어 있습니다. 예를 들어 KSNODEPROPERTY 구조체는 KSPROPERTY 구조체로 시작하지만 노드 식별자도 포함하는 속성 설명자입니다.
속성 값 형식

속성에는 값이 있고 이 값의 형식은 속성에 따라 달라집니다. 예를 들어 온 또는 오프 상태 중 하나에 있을 수 있는 속성에는 일반적으로 BOOL 값이 있습니다. 정수 값을 0x0 0xFFFFFFFF 가정할 수 있는 속성에는 ULONG 값이 있을 수 있습니다. 더 복잡한 속성에는 배열 또는 구조체인 값이 있을 수 있습니다.

위의 속성 설명자 및 속성 값은 KS 속성, 이벤트 및 메서드에서 설명하는 instance 사양 및 작업 데이터 버퍼의 속성별 버전입니다.

속성 요청은 다음 플래그 중 하나를 사용하여 속성에서 수행할 작업을 지정합니다.

KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET

모든 필터 및 핀 개체는 해당 속성에 대한 기본 지원 작업을 지원합니다. get 및 Set 작업을 지원하는지 여부는 속성에 따라 달라집니다. 필터 또는 핀 개체의 고유 기능을 나타내는 속성은 가져오기 작업만 필요할 수 있습니다. 구성 가능한 설정을 나타내는 속성에는 설정 작업만 필요할 수 있지만 get 작업은 현재 설정을 읽는 데 유용할 수도 있습니다. 비디오 캡처 속성과 함께 가져오기, 설정 및 기본 지원 작업을 사용하는 방법에 대한 자세한 내용은 KS 속성을 참조하세요.

모든 속성 설명에는 비디오 캡처 미니드라이버가 속성 읽기 또는 쓰기를 지원해야 하는지 여부를 나타내는 테이블이 포함되어 있습니다. 비디오 캡처 미니드라이버가 미니드라이버에서 지원하지 않는 속성에 대한 요청을 받거나 설정하려면 응답으로 STATUS_NOT_SUPPORTED 반환해야 합니다.

다음 목록에서는 비디오 캡처 미니드라이버에서 사용하는 커널 스트리밍 속성 집합에 대해 설명합니다.

PROPSETID_ALLOCATOR_CONTROL

PROPSETID_EXT_DEVICE

PROPSETID_EXT_TRANSPORT

PROPSETID_TIMECODE_READER

PROPSETID_TUNER

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_CROSSBAR

PROPSETID_VIDCAP_DROPPEDFRAMES

PROPSETID_VIDCAP_TVAUDIO

PROPSETID_VIDCAP_VIDEOCOMPRESSION