PCAUTOMATION_TABLE structure (portcls.h)

The PCAUTOMATION_TABLE structure contains a miniport driver's master table of properties, methods, and events.

Syntax

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;

Members

PropertyItemSize

Specifies the size in bytes of the property structure used. Set this member to sizeof(PCPROPERTY_ITEM) or greater. See the following Remarks section.

PropertyCount

Specifies the number of property items in the Properties array.

Properties

Pointer to the filter's array of properties. This is an array of PCPROPERTY_ITEM structures.

MethodItemSize

Specifies the size in bytes of the methods structure used. Set this member to sizeof(PCMETHOD_ITEM) or greater. See the following Remarks section.

MethodCount

Specifies the number of method items in the Methods array.

Methods

Pointer to the filter's array of methods. This is an array of PCMETHOD_ITEM structures.

EventItemSize

Specifies the size in bytes of the event structure used. Set this member to sizeof(PCEVENT_ITEM) or greater. See the following Remarks section.

EventCount

Specifies the number of event items in the Events array.

Events

Pointer to the filter's array of events. This is an array of PCEVENT_ITEM structures.

Reserved

Reserved. Initialize to zero.

Remarks

Any of the structure's item pointers can be NULL, in which case the corresponding counts should be zero. For item tables that are not zero length, the item size should not be smaller than the size of the corresponding item structure that is defined in the header file portcls.h. The minimum size for a property, event, or method item is sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM), or sizeof(PCMETHOD_ITEM), respectively. The item size can be larger than this, in which case the item structure is followed by whatever private data the miniport driver appends to it. Item sizes should be a multiple of eight.

The IMiniport::GetDescription method outputs a PCFILTER_DESCRIPTOR structure that points to a PCAUTOMATION_TABLE structure that specifies the miniport driver's automation table.

Requirements

Requirement	Value
Header	portcls.h (include Portcls.h)

See also

IMiniport::GetDescription

PCEVENT_ITEM

PCFILTER_DESCRIPTOR

PCMETHOD_ITEM

PCPROPERTY_ITEM