本部分介绍视频捕获特定的属性集,这些属性集可用于在 Microsoft Windows XP、Windows 2000 和 Windows 98/Me 及更高版本中使用 WDM 内核流式处理服务的视频捕获微型驱动程序。
每个属性的引用页包含具有以下列标题的表。
| Get | Set | Target | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
这些标题具有以下含义:
Get
目标 KS 对象是否支持KSPROPERTY_TYPE_GET属性请求?
Set
目标 KS 对象是否支持KSPROPERTY_TYPE_SET属性请求?
Target
目标是将属性请求发送到的 KS 对象。 视频捕获属性的目标是筛选器或引脚。 (属性请求通过其内核句柄指定目标对象。
属性描述符类型
属性描述符指定要对该属性执行的属性和作。 The descriptor always begins with a KSPROPERTY structure, but some types of descriptor contain additional information. For example, the KSNODEPROPERTY structure is a property descriptor that begins with a KSPROPERTY structure but also includes a node identifier.
属性值类型
属性具有一个值,该值的类型取决于该属性。 例如,一个属性只能处于两个状态之一(开或关)通常具有 BOOL 值。 可以假定从0x0到0xFFFFFFFF的整数值的属性可能具有 ULONG 值。 更复杂的属性可能具有数组或结构的值。
上述属性描述符和属性值是 KS 属性、事件和方法 讨论的特定于实例规范和作数据缓冲区的属性版本。
属性请求使用以下标志之一指定要对属性执行的作:
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
所有筛选器和固定对象都支持对其属性执行基本支持作。 Whether they support the get and Set operations depends on the property. 表示筛选器或 pin 对象的固有功能的属性可能只需要获取作。 A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video capture properties, see KS Properties.
每个属性说明都包含一个表,该表指示视频捕获微型驱动程序是否必须支持读取或写入该属性。 视频捕获微型驱动程序应返回STATUS_NOT_SUPPORTED以响应获取或设置微型驱动程序不支持的属性的请求。
以下列表描述了视频捕获微型驱动程序使用的内核流式处理属性集:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
以下属性集可用于 USB 视频类驱动程序:
PROPSETID_VIDCAP_CAMERACONTROL