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

Статья
02/07/2025

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

Синтаксис

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

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

PropertyCount

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

Properties

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

MethodItemSize

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

MethodCount

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

Methods

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

EventItemSize

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

EventCount

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

Events

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

Reserved

Скрытный. Инициализация до нуля.

Замечания

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

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