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內部使用。 Minidrivers 不應該操作這個成員。

備註

請注意，每個物件 (針腳、篩選、拓撲節點) 都應該定義自動化數據表。 Minidrivers 可以使用 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