estrutura PCAUTOMATION_TABLE (portcls.h)

Artigo
02/29/2024

A estrutura PCAUTOMATION_TABLE contém a tabela master de propriedades, métodos e eventos de um driver de miniport.

Sintaxe

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;

Membros

PropertyItemSize

Especifica o tamanho em bytes da estrutura de propriedade usada. Defina esse membro como sizeof(PCPROPERTY_ITEM) ou superior. Consulte a seção Comentários a seguir.

PropertyCount

Especifica o número de itens de propriedade na matriz Propriedades .

Properties

Ponteiro para a matriz de propriedades do filtro. Essa é uma matriz de estruturas PCPROPERTY_ITEM .

MethodItemSize

Especifica o tamanho em bytes da estrutura de métodos usada. Defina esse membro como sizeof(PCMETHOD_ITEM) ou superior. Consulte a seção Comentários a seguir.

MethodCount

Especifica o número de itens de método na matriz Métodos .

Methods

Ponteiro para a matriz de métodos do filtro. Essa é uma matriz de estruturas PCMETHOD_ITEM .

EventItemSize

Especifica o tamanho em bytes da estrutura de eventos usada. Defina esse membro como sizeof(PCEVENT_ITEM) ou superior. Consulte a seção Comentários a seguir.

EventCount

Especifica o número de itens de evento na matriz Eventos .

Events

Ponteiro para a matriz de eventos do filtro. Essa é uma matriz de estruturas PCEVENT_ITEM .

Reserved

Reservado. Inicialize para zero.

Comentários

Qualquer um dos ponteiros de item da estrutura pode ser NULL; nesse caso, as contagens correspondentes devem ser zero. Para tabelas de itens que não têm comprimento zero, o tamanho do item não deve ser menor do que o tamanho da estrutura de item correspondente definida no arquivo de cabeçalho portcls.h. O tamanho mínimo de uma propriedade, evento ou item de método é sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) ou sizeof(PCMETHOD_ITEM), respectivamente. O tamanho do item pode ser maior do que esse, caso em que a estrutura do item é seguida por quaisquer dados privados que o driver de miniporto acrescenta a ele. Os tamanhos dos itens devem ser múltiplos de oito.

O método IMiniport::GetDescription gera uma estrutura PCFILTER_DESCRIPTOR que aponta para uma estrutura PCAUTOMATION_TABLE que especifica a tabela de automação do driver de miniport.