KSCAMERA_EXTENDEDPROP_HEADER structure (ksmedia.h)

The KSCAMERA_EXTENDEDPROP_HEADER structure is the payload header for an extended control property.

Syntax

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

Members

Version

The extended property version number. This is set to 1.

PinId

The pin ID that corresponds with the property. If PinId is set to (ULONG)-1, the control applies to the filter. Otherwise, the camera driver must route this control to the corresponding pin when that pin is created (or if already available).

Size

The total size, in bytes of the entire payload. This includes the KSCAMERA_EXTENDEDPROP_HEADER structure and the following control specific payload data.

Result

For a set operation, this is 0. For queries, Result contains any failure code the driver provides for the most recent control operation.

Flags

The settings in Flags may vary depending on the control.

The high order bit of the Flags value is reserved. This bit serves as the cancel flag and is defined as KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION. This flag is only meaningful for asynchronous controls.

Capability

This member is read only and indicates the standard capabilities of the control.

The following capabilities are defined.

Requirements

See also

KSCAMERA_EXTENDEDPROP_VALUE