estructura PCAUTOMATION_TABLE (portcls.h)

Artículo
02/26/2024

La estructura PCAUTOMATION_TABLE contiene una tabla maestra del controlador de miniporte de propiedades, métodos y eventos.

Sintaxis

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;

Miembros

PropertyItemSize

Especifica el tamaño en bytes de la estructura de propiedades usada. Establezca este miembro en sizeof(PCPROPERTY_ITEM) o superior. Consulte la siguiente sección Comentarios.

PropertyCount

Especifica el número de elementos de propiedad de la matriz Properties .

Properties

Puntero a la matriz de propiedades del filtro. Se trata de una matriz de estructuras de PCPROPERTY_ITEM .

MethodItemSize

Especifica el tamaño en bytes de la estructura de métodos usada. Establezca este miembro en sizeof(PCMETHOD_ITEM) o superior. Consulte la siguiente sección Comentarios.

MethodCount

Especifica el número de elementos de método en la matriz Methods .

Methods

Puntero a la matriz de métodos del filtro. Se trata de una matriz de estructuras de PCMETHOD_ITEM .

EventItemSize

Especifica el tamaño en bytes de la estructura de eventos utilizada. Establezca este miembro en sizeof(PCEVENT_ITEM) o superior. Consulte la siguiente sección Comentarios.

EventCount

Especifica el número de elementos de evento de la matriz Events .

Events

Puntero a la matriz de eventos del filtro. Se trata de una matriz de estructuras de PCEVENT_ITEM .

Reserved

Reservado. Inicialice en cero.

Comentarios

Cualquiera de los punteros de elemento de la estructura puede ser NULL, en cuyo caso los recuentos correspondientes deben ser cero. Para las tablas de elementos que no son de longitud cero, el tamaño del elemento no debe ser menor que el tamaño de la estructura de elementos correspondiente definida en el archivo de encabezado portcls.h. El tamaño mínimo de un elemento de propiedad, evento o método es sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) o sizeof(PCMETHOD_ITEM), respectivamente. El tamaño del elemento puede ser mayor que este, en cuyo caso la estructura del elemento va seguida de los datos privados que el controlador de miniporte anexa. Los tamaños de elemento deben ser un múltiplo de ocho.

El método IMiniport::GetDescription genera una estructura PCFILTER_DESCRIPTOR que apunta a una estructura de PCAUTOMATION_TABLE que especifica la tabla de automatización del controlador de miniporte.