PCAUTOMATION_TABLE-Struktur (portcls.h)

Artikel
02/29/2024

Die PCAUTOMATION_TABLE-Struktur enthält die master Tabelle mit Eigenschaften, Methoden und Ereignissen eines Miniporttreibers.

Syntax

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;

Member

PropertyItemSize

Gibt die Größe der verwendeten Eigenschaftenstruktur in Bytes an. Legen Sie diesen Member auf sizeof(PCPROPERTY_ITEM) oder höher fest. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

PropertyCount

Gibt die Anzahl der Eigenschaftenelemente im Eigenschaftenarray an.

Properties

Zeiger auf das Eigenschaftenarray des Filters. Dies ist ein Array von PCPROPERTY_ITEM Strukturen.

MethodItemSize

Gibt die Größe der verwendeten Methodenstruktur in Bytes an. Legen Sie dieses Element auf sizeof(PCMETHOD_ITEM) oder höher fest. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

MethodCount

Gibt die Anzahl der Methodenelemente im Methodenarray an.

Methods

Zeiger auf das Methodenarray des Filters. Dies ist ein Array von PCMETHOD_ITEM Strukturen.

EventItemSize

Gibt die Größe der verwendeten Ereignisstruktur in Bytes an. Legen Sie dieses Element auf sizeof(PCEVENT_ITEM) oder höher fest. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

EventCount

Gibt die Anzahl der Ereigniselemente im Array Ereignisse an.

Events

Zeiger auf das Array von Ereignissen des Filters. Dies ist ein Array von PCEVENT_ITEM Strukturen.

Reserved

Reserviert. Initialisieren Sie mit null.

Hinweise

Jeder Elementzeiger der Struktur kann NULL sein, in diesem Fall sollte die entsprechende Anzahl 0 sein. Bei Elementtabellen, die keine Länge von 0 haben, sollte die Elementgröße nicht kleiner als die Größe der entsprechenden Elementstruktur sein, die in der Headerdatei portcls.h definiert ist. Die Mindestgröße für ein Eigenschafts-, Ereignis- oder Methodenelement ist sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) bzw . sizeof(PCMETHOD_ITEM). Die Elementgröße kann größer sein. In diesem Fall folgen auf die Elementstruktur die privaten Daten, die der Miniporttreiber an sie angibt. Die Elementgrößen sollten ein Vielfaches von acht aufweisen.

Die IMiniport::GetDescription-Methode gibt eine PCFILTER_DESCRIPTOR-Struktur aus, die auf eine PCAUTOMATION_TABLE-Struktur verweist, die die Automatisierungstabelle des Miniporttreibers angibt.