展开 最小化

KSCAMERA_EXTENDEDPROP_HEADER structure

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

Syntax


typedef struct _KSCAMERA_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.

ValueMeaning
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL

The control supports asynchronous operation.

KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE

Applies only to asynchronous controls. This flag marks the control operation as cancellable. If a synchronous control sets this flag, it is be marked as being invalid and is not exposed to higher level applications.

 

Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Header

Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_VALUE

 

 

Send comments about this topic to Microsoft

显示:
© 2014 Microsoft