다음을 통해 공유

KSCAMERA_EXTENDEDPROP_HEADER 구조체(ksmedia.h)

  • 아티클

KSCAMERA_EXTENDEDPROP_HEADER 구조체는 확장된 컨트롤 속성에 대한 페이로드 헤더입니다.

구문

typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
  ULONG     Version;
  ULONG     PinId;
  ULONG     Size;
  ULONG     Result;
  ULONGLONG Flags;
  ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;

멤버

Version

확장 속성 버전 번호입니다. 이 값은 1로 설정됩니다.

PinId

속성에 해당하는 핀 ID입니다. PinId가 (ULONG)-1로 설정된 경우 컨트롤이 필터에 적용됩니다. 그렇지 않으면 카메라 드라이버는 해당 핀을 만들 때(또는 이미 사용 가능한 경우) 해당 핀으로 이 컨트롤을 라우팅해야 합니다.

Size

전체 페이로드의 총 크기(바이트)입니다. 여기에는 KSCAMERA_EXTENDEDPROP_HEADER 구조와 다음과 같은 컨트롤 특정 페이로드 데이터가 포함됩니다.

Result

집합 작업의 경우 0입니다. 쿼리의 경우 Result 에는 드라이버가 가장 최근의 제어 작업에 대해 제공하는 오류 코드가 포함됩니다.

Flags

플래그의 설정은 컨트롤에 따라 달라질 수 있습니다.

Flags 값의 상위 비트가 예약되어 있습니다. 이 비트는 취소 플래그 역할을 하며 KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 정의됩니다. 이 플래그는 비동기 컨트롤에만 의미가 있습니다.

Capability

이 멤버는 읽기 전용이며 컨트롤의 표준 기능을 나타냅니다.

다음 기능이 정의됩니다.

값 Description
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL 컨트롤은 비동기 작업을 지원합니다.
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE 비동기 컨트롤에만 적용됩니다. 이 플래그는 컨트롤 작업을 취소할 수 있는 것으로 표시합니다. 동기 컨트롤이 이 플래그를 설정하는 경우 잘못된 것으로 표시되고 상위 수준 애플리케이션에 노출되지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1
지원되는 최소 서버 Windows Server 2012 R2
머리글 ksmedia.h(Ksmedia.h 포함)

추가 정보

KSCAMERA_EXTENDEDPROP_VALUE