다음을 통해 공유


인코더 속성 집합

이 섹션에서는 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

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

모든 속성에 대한 설명의 표는 비디오 인코더 미니드라이버가 속성 읽기 또는 쓰기를 지원하는 데 필요한지 여부를 나타냅니다. 비디오 인코더 미니 드라이버는 미니 드라이버에서 지원되지 않는 속성에 대한 요청을 받거나 설정하기 위한 응답으로 STATUS_NOT_SUPPORTED 반환해야 합니다.

다음 속성 집합에는 각각 비디오 인코더 미니 드라이버에서 구현해야 하는 단일 속성이 포함되어 있습니다. 즉, 실제로 각 속성은 자체 집합을 가져오므로 필요에 따라 KSPROPERTY_SET 구조체에서 KSPROPERTY_ITEM 멤버의 PropertyId 멤버에 0을 지정합니다.

다음 속성 집합은 코덱 API에 속합니다.

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

다음 속성 집합은 인코더 API에 속합니다.

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE