PCAUTOMATION_TABLE Struktur (portcls.h)

2025-02-07

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

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;

Angehörige

PropertyItemSize

Gibt die Größe in Byte der verwendeten Eigenschaftsstruktur an. Legen Sie dieses Element auf Größe von(PCPROPERTY_ITEM) oder höher fest. Siehe den folgenden Abschnitt "Hinweise".

PropertyCount

Gibt die Anzahl der Eigenschaftselemente im Properties Array an.

Properties

Zeigen Sie auf das Array der Eigenschaften des Filters. Dies ist ein Array von PCPROPERTY_ITEM Strukturen.

MethodItemSize

Gibt die Größe in Byte der verwendeten Methodenstruktur an. Legen Sie dieses Element auf Größe von(PCMETHOD_ITEM) oder höher fest. Siehe den folgenden Abschnitt "Hinweise".

MethodCount

Gibt die Anzahl der Methodenelemente im Methoden Array an.

Methods

Zeigen Sie auf das Array der Methoden des Filters. Dies ist ein Array von PCMETHOD_ITEM Strukturen.

EventItemSize

Gibt die Größe in Byte der verwendeten Ereignisstruktur an. Legen Sie dieses Element auf Größe von(PCEVENT_ITEM) oder höher fest. Siehe den folgenden Abschnitt "Hinweise".

EventCount

Gibt die Anzahl der Ereigniselemente im Events Array an.

Events

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

Reserved

Reserviert. Initialisieren sie auf Null.

Bemerkungen

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

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