PCAUTOMATION_TABLE struttura (portcls.h)

Articolo
02/26/2024

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;

Members

PropertyItemSize

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

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 usata. Impostare questo membro su sizeof(PCMETHOD_ITEM) o maggiore. Vedere la sezione Osservazioni seguenti.

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 maggiore. Vedere la sezione Osservazioni seguenti.

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.

Commenti

Uno dei puntatori dell'elemento della struttura può essere NULL, nel qual caso i conteggi corrispondenti devono essere zero. Per le tabelle di elementi che non sono di lunghezza zero, le dimensioni dell'elemento non devono essere inferiori alle dimensioni della struttura di elemento corrispondente definita nella porta del file di intestazionecls.h. Le dimensioni minime per un elemento di proprietà, evento o metodo sono sizeof(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 dati privato che il driver miniport aggiunge a esso. Le dimensioni degli elementi devono essere un multiplo 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.