인코더 속성 집합
이 섹션에서는 Microsoft Windows 98/Me, Windows 2000 및 Windows XP 이상에서 WDM 커널 스트리밍 서비스를 사용하는 인코더 미니드라이버에 사용할 수 있는 인코더 및 코덱 API 관련 속성 집합에 대해 설명합니다.
각 속성에 대한 참조 페이지에는 아래에 표시된 열 머리글이 있는 테이블이 포함되어 있습니다.
가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
---|---|---|---|---|
이러한 제목에는 다음과 같은 의미가 있습니다.
가져오기
대상 KS 개체가 KSPROPERTY_TYPE_GET 속성 요청을 지원하나요?
설정
대상 KS 개체가 KSPROPERTY_TYPE_SET 속성 요청을 지원하나요?
대상
속성 요청이 전송되는 KS 개체입니다. 비디오 인코더 속성의 대상은 필터 또는 핀입니다. (속성 요청은 커널 핸들에 의해 대상 개체를 지정합니다.)
속성 설명자 형식
속성 설명자는 해당 속성에 대해 수행할 속성과 작업을 지정합니다. 설명자는 항상 KSPROPERTY 구조체로 시작합니다.
속성 값 형식
속성에는 값이 있고 이 값의 형식은 속성에 따라 달라집니다. 예를 들어 켜기 또는 끄기 상태 중 하나일 수 있는 속성에는 일반적으로 BOOL 값이 있습니다. 0x0 0xFFFFFFFF 정수 값을 가정할 수 있는 속성은 ULONG 값을 가질 수 있습니다. 더 복잡한 속성에는 배열 또는 구조체인 값이 있을 수 있습니다.
위의 속성 설명자 및 속성 값은 KS 속성, 이벤트 및 메서드에서 설명하는 instance 사양 및 작업 데이터 버퍼의 속성별 버전입니다.
속성 요청은 다음 플래그 중 하나를 사용하여 속성에서 수행할 작업을 지정합니다.
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
모든 필터 및 핀 개체는 해당 속성에 대한 기본 지원 작업을 지원합니다. get 및 Set 작업을 지원하는지 여부는 속성에 따라 달라집니다. 필터 또는 핀 개체의 고유 기능을 나타내는 속성은 get 작업만 필요할 수 있습니다. 구성 가능한 설정을 나타내는 속성에는 설정 작업만 필요할 수 있지만 get 작업은 현재 설정을 읽는 데에도 유용할 수 있습니다. 비디오 인코더 속성과 함께 get, set 및 basic-support 작업을 사용하는 방법에 대한 자세한 내용은 KS 속성을 참조하세요.
모든 속성에 대한 설명의 표는 비디오 인코더 미니드라이버가 속성 읽기 또는 쓰기를 지원하는 데 필요한지 여부를 나타냅니다. 비디오 인코더 미니 드라이버는 미니 드라이버에서 지원되지 않는 속성에 대한 요청을 받거나 설정하기 위한 응답으로 STATUS_NOT_SUPPORTED 반환해야 합니다.
다음 속성 집합에는 각각 비디오 인코더 미니 드라이버에서 구현해야 하는 단일 속성이 포함되어 있습니다. 즉, 실제로 각 속성은 자체 집합을 가져오므로 필요에 따라 KSPROPERTY_SET 구조체에서 KSPROPERTY_ITEM 멤버의 PropertyId 멤버에 0을 지정합니다.
다음 속성 집합은 코덱 API에 속합니다.
다음 속성 집합은 인코더 API에 속합니다.