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

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

MethodSetsCount

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

MethodItemSize

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

MethodSets

定义此自动化表中的方法集的 KSMETHOD_SET 对象数组(MethodSetsCount 长度)。 每个集的大小 MethodItemSize中都有一个特定的项数。

EventSetsCount

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

EventItemSize

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

EventSets

定义此自动化表中的事件集的 KSEVENT_SET 对象数组(EventSetsCount 长度)。 每个集都有一个特定数量的项,其大小 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