ksmedia.h) (KSCAMERA_EXTENDEDPROP_HEADER 结构

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

此成员是只读的,指示控件的标准功能。

定义了以下功能。

说明
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL 控件支持异步操作。
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE 仅适用于异步控件。 此标志将控制操作标记为可取消。 如果同步控件设置此标志,则会将其标记为无效,并且不会向更高级别的应用程序公开。

要求

要求
最低受支持的客户端 Windows 8.1
最低受支持的服务器 Windows Server 2012 R2
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

KSCAMERA_EXTENDEDPROP_VALUE