struttura PCAUTOMATION_TABLE (portcls.h)

Articolo
02/07/2025

La struttura PCAUTOMATION_TABLE contiene una tabella master del driver miniport di proprietà, metodi ed eventi.

Sintassi

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;

Membri

PropertyItemSize

Specifica le dimensioni in byte della struttura di proprietà utilizzata. Impostare questo membro su sizeof(PCPROPERTY_ITEM) o superiore. Vedere la sezione Osservazioni seguente.

PropertyCount

Specifica il numero di elementi della proprietà nella matrice Proprietà.

Properties

Puntatore alla matrice di proprietà del filtro. Si tratta di una matrice di strutture PCPROPERTY_ITEM.

MethodItemSize

Specifica le dimensioni in byte della struttura dei metodi utilizzata. Impostare questo membro su sizeof(PCMETHOD_ITEM) o superiore. Vedere la sezione Osservazioni seguente.

MethodCount

Specifica il numero di elementi del metodo nella matrice metodi.

Methods

Puntatore alla matrice di metodi del filtro. Si tratta di una matrice di strutture PCMETHOD_ITEM.

EventItemSize

Specifica le dimensioni in byte della struttura di eventi utilizzata. Impostare questo membro su sizeof(PCEVENT_ITEM) o superiore. Vedere la sezione Osservazioni seguente.

EventCount

Specifica il numero di elementi dell'evento nella matrice eventi.

Events

Puntatore alla matrice di eventi del filtro. Si tratta di una matrice di strutture PCEVENT_ITEM.

Reserved

Riservato. Inizializzare su zero.

Osservazioni

I puntatori agli elementi della struttura possono essere NULL, nel qual caso i conteggi corrispondenti devono essere pari a zero. Per le tabelle degli elementi che non hanno lunghezza zero, le dimensioni dell'elemento non devono essere inferiori alle dimensioni della struttura di elementi corrispondente definita nel file di intestazione portcls.h. La dimensione minima per una proprietà, un evento o un elemento del metodo è dimensione di(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) o sizeof(PCMETHOD_ITEM), rispettivamente. La dimensione dell'elemento può essere maggiore di questa, nel qual caso la struttura dell'elemento è seguita da qualsiasi dato privato aggiunto dal driver miniport. Le dimensioni degli elementi devono essere multiple di otto.

Il metodo IMiniport::GetDescription restituisce una struttura PCFILTER_DESCRIPTOR che punta a una struttura PCAUTOMATION_TABLE che specifica la tabella di automazione del driver miniport.