PCAUTOMATION_TABLE 结构 (portcls.h)

项目
03/05/2024

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

指定所用属性结构的大小（以字节为单位）。将此成员设置为 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) 。项大小可以大于此大小，在这种情况下，项结构后跟微型端口驱动程序向其追加的任何私有数据。项大小应为 8 的倍数。

IMiniport：：GetDescription 方法输出指向指定微型端口驱动程序自动化表的PCAUTOMATION_TABLE结构的PCFILTER_DESCRIPTOR结构。