KSAUTOMATION_TABLE 结构 (ks.h)

KSAUTOMATION_TABLE 结构定义一个结构,该结构合并属性、方法和事件的表。

语法

typedef struct KSAUTOMATION_TABLE_ {
  ULONG                PropertySetsCount;
  ULONG                PropertyItemSize;
  const KSPROPERTY_SET *PropertySets;
  ULONG                MethodSetsCount;
  ULONG                MethodItemSize;
  const KSMETHOD_SET   *MethodSets;
  ULONG                EventSetsCount;
  ULONG                EventItemSize;
  const KSEVENT_SET    *EventSets;
  PVOID                Alignment;
} KSAUTOMATION_TABLE, *PKSAUTOMATION_TABLE;

成员

PropertySetsCount

此成员指定此自动化表中的属性集数。

PropertyItemSize

此成员指定此表中属性项的大小(以字节为单位)。

PropertySets

指向长度 (PropertySetsCount KSPROPERTY_SET 对象数组的指针,) 在此自动化表中定义属性集。 每个集包含特定数量的 PropertyItemSize 大小的项。

MethodSetsCount

此成员指定此自动化表中的方法集数。

MethodItemSize

此成员指定此表中方法项的大小(以字节为单位)。

MethodSets

在定义此自动化表中的方法集) 长度 (MethodSetsCountKSMETHOD_SET对象数组。 每个集都有特定数量的项,其大小 为 MethodItemSize

EventSetsCount

此成员指定此自动化表中的事件集数。

EventItemSize

此成员指定此表中事件项的大小(以字节为单位)。

EventSets

定义此自动化表中 的事件 集) 长度 (EventSetsCount 的KSEVENT_SET对象数组。 每个集都有一个特定数量的项,其大小为 EventItemSize

Alignment

保留供 AVStream 内部使用。 微型驱动程序不应操作此成员。

注解

请注意, (固定、筛选器、拓扑节点) 的每个对象都应定义一个自动化表。 微型驱动程序可以使用 Ks.h 中定义的宏来定义自动化表及其包含的数组:

  • DEFINE_KSAUTOMATION_TABLE

  • DEFINE_KSAUTOMATION_PROPERTIES

  • DEFINE_KSAUTOMATION_METHODS

  • DEFINE_KSAUTOMATION_EVENTS

指定包含空属性数组、事件数组或方法数组的自动化表:

  • DEFINE_KSAUTOMATION_PROPERTIES_NULL

  • DEFINE_KSAUTOMATION_METHODS_NULL

  • DEFINE_KSAUTOMATION_EVENTS_NULL

例如:

DEFINE_KSAUTOMATION_TABLE (MyAutomationTable) {
    DEFINE_KSAUTOMATION_PROPERTIES (MyPropertyTable),
    DEFINE_KSAUTOMATION_METHODS (MyMethodTable),
    DEFINE_KSAUTOMATION_EVENTS (MyEventTable)
    };

要求

要求
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的操作系统以及 Microsoft DirectX 8.0 及更高版本中可用。
标头 ks.h (包括 Ks.h)

另请参阅

KSEVENT_ITEM

KSEVENT_SET

KSMETHOD_ITEM

KSMETHOD_SET

KSPROPERTY_ITEM

KSPROPERTY_SET