структура KSAUTOMATION_TABLE (ks.h)

Статья
08/07/2023

Структура 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)