estrutura PCAUTOMATION_TABLE (portcls.h)

Artigo
02/07/2025

A estrutura PCAUTOMATION_TABLE contém a tabela mestra 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 propriedades usada. Defina esse membro como tamanhos de(PCPROPERTY_ITEM) ou superior. Consulte a seção Comentários a seguir.

PropertyCount

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

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 tamanhos de(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. Esta é uma matriz de estruturas PCMETHOD_ITEM.

EventItemSize

Especifica o tamanho em bytes da estrutura de eventos usada. Defina esse membro como tamanhos de(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.

Observações

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 tamanho 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 é tamanhos de(PCPROPERTY_ITEM), tamanhos de(PCEVENT_ITEM) ou tamanhos de(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 de PCAUTOMATION_TABLE que especifica a tabela de automação do driver de miniport.