视频捕获微型驱动程序属性集

本部分介绍视频捕获特定的属性集,这些属性集可用于视频捕获微型驱动程序,这些属性在 Microsoft Windows XP、Windows 2000 和 Windows 98/Me 和更高版本的操作系统中使用 WDM 内核流式处理服务。

每个属性的引用页面都包含一个具有以下列标题的表。

获取 设置 目标 属性描述符类型 属性值类型

这些标题具有以下含义:

  • Get

    目标 KS 对象是否支持 KSPROPERTY_TYPE_GET 属性请求?

  • 设置

    目标 KS 对象是否支持 KSPROPERTY_TYPE_SET 属性请求?

  • 目标

    目标是向其发送属性请求的 KS 对象。 视频捕获属性的目标是筛选器或 pin。 (属性请求按其内核句柄指定目标对象。 )

  • 属性描述符类型

    属性说明符指定属性和要对该属性执行的操作。 描述符始终以 KSPROPERTY 结构开始,但某些类型的描述符包含附加信息。 例如, KSNODEPROPERTY 结构是以 KSPROPERTY 结构开头但还包含节点标识符的属性描述符。

  • 属性值类型

    属性具有值,并且此值的类型取决于属性。 例如,一个只能处于两种状态的属性(打开或关闭)通常具有 BOOL 值。 可以假设从0x0 到0xFFFFFFFF 的整数值的属性可能具有 ULONG 值。 更复杂的属性可能具有作为数组或结构的值。

以上属性说明符和属性值是 KS 属性、事件和方法 讨论的实例规范和操作数据缓冲区的属性特定版本。

属性请求使用下列标志之一来指定要对属性执行的操作:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

所有筛选器和 pin 对象均支持对其属性的基本支持操作。 它们是否支持 getSet 操作取决于属性。 表示筛选器或固定对象的固有功能的属性可能只需要 get 操作。 尽管获取操作也可能对读取当前设置很有用,但表示可配置的设置的属性可能只需要 设置 操作。 若要详细了解如何使用视频捕获属性的 get、set 和 basic 支持操作,请参阅 KS properties

每个属性说明都包含一个表,用于指示视频捕获微型驱动程序是否必须支持读取或写入属性。 视频捕获微型驱动程序应返回 STATUS_NOT_SUPPORTED,以响应微型驱动程序不支持的属性的 get 或 set 请求。

以下列表描述了视频捕获微型驱动程序使用的内核流式处理属性集:

PROPSETID_ALLOCATOR_CONTROL

PROPSETID_EXT_DEVICE

PROPSETID_EXT_TRANSPORT

PROPSETID_TIMECODE_READER

PROPSETID_TUNER

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_CROSSBAR

PROPSETID_VIDCAP_DROPPEDFRAMES

PROPSETID_VIDCAP_TVAUDIO

PROPSETID_VIDCAP_VIDEOCOMPRESSION

PROPSETID_VIDCAP_VIDEOCONTROL

PROPSETID_VIDCAP_VIDEODECODER

PROPSETID_VIDCAP_VIDEOPROCAMP

以下属性集可与 USB 视频类驱动程序一起使用:

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_VIDEOPROCAMP

PROPSETID_VIDCAP_SELECTOR