структура PCAUTOMATION_TABLE (portcls.h)

Статья
08/07/2023

Структура PCAUTOMATION_TABLE содержит master таблицу свойств, методов и событий драйвера мини-порта.

Синтаксис

typedef struct {
  ULONG                 PropertyItemSize;
  ULONG                 PropertyCount;
  const PCPROPERTY_ITEM *Properties;
  ULONG                 MethodItemSize;
  ULONG                 MethodCount;
  const PCMETHOD_ITEM   *Methods;
  ULONG                 EventItemSize;
  ULONG                 EventCount;
  const PCEVENT_ITEM    *Events;
  ULONG                 Reserved;
} PCAUTOMATION_TABLE, *PPCAUTOMATION_TABLE;

Члены

PropertyItemSize

Задает размер используемой структуры свойств в байтах. Задайте для этого элемента значение sizeof(PCPROPERTY_ITEM) или больше. См. следующий раздел Примечаний.

PropertyCount

Указывает количество элементов свойств в массиве Properties .

Properties

Указатель на массив свойств фильтра. Это массив PCPROPERTY_ITEM структур.

MethodItemSize

Задает размер используемой структуры методов в байтах. Задайте для этого элемента значение sizeof(PCMETHOD_ITEM) или больше. См. следующий раздел Примечаний.

MethodCount

Указывает количество элементов метода в массиве Methods .

Methods

Указатель на массив методов фильтра. Это массив PCMETHOD_ITEM структур.

EventItemSize

Задает размер используемой структуры событий в байтах. Задайте для этого элемента значение sizeof(PCEVENT_ITEM) или больше. См. следующий раздел Примечаний.

EventCount

Указывает количество элементов событий в массиве Events .

Events

Указатель на массив событий фильтра. Это массив PCEVENT_ITEM структур.

Reserved

Зарезервировано. Инициализируйте до нуля.

Любой из указателей элементов структуры может иметь значение NULL, и в этом случае соответствующее число должно быть равно нулю. Для таблиц элементов, длина которых не равна нулю, размер элемента не должен быть меньше размера соответствующей структуры элементов, определенной в файле заголовка portcls.h. Минимальный размер элемента свойства, события или метода — sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) или sizeof(PCMETHOD_ITEM) соответственно. Размер элемента может быть больше, чем этот. В этом случае за структурой элемента следуют любые частные данные, добавляемые драйвером мини-порта к нему. Размер элемента должен быть кратным восьми.

Метод IMiniport::GetDescription выводит PCFILTER_DESCRIPTOR структуру, указывающую на PCAUTOMATION_TABLE структуру, указывающую таблицу автоматизации драйвера мини-порта.