structure PCAUTOMATION_TABLE (portcls.h)

Article
02/29/2024

La structure PCAUTOMATION_TABLE contient les master table de propriétés, de méthodes et d’événements d’un pilote miniport.

Syntaxe

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;

Membres

PropertyItemSize

Spécifie la taille en octets de la structure de propriété utilisée. Définissez ce membre sur sizeof(PCPROPERTY_ITEM) ou supérieur. Consultez la section Remarques suivante.

PropertyCount

Spécifie le nombre d’éléments de propriété dans le tableau Propriétés .

Properties

Pointeur vers le tableau de propriétés du filtre. Il s’agit d’un tableau de structures PCPROPERTY_ITEM .

MethodItemSize

Spécifie la taille en octets de la structure de méthodes utilisée. Définissez ce membre sur sizeof(PCMETHOD_ITEM) ou supérieur. Consultez la section Remarques suivante.

MethodCount

Spécifie le nombre d’éléments de méthode dans le tableau Méthodes .

Methods

Pointeur vers le tableau de méthodes du filtre. Il s’agit d’un tableau de structures PCMETHOD_ITEM .

EventItemSize

Spécifie la taille en octets de la structure d’événements utilisée. Définissez ce membre sur sizeof(PCEVENT_ITEM) ou supérieur. Consultez la section Remarques suivante.

EventCount

Spécifie le nombre d’éléments d’événements dans le tableau Événements .

Events

Pointeur vers le tableau d’événements du filtre. Il s’agit d’un tableau de structures PCEVENT_ITEM .

Reserved

Réservé. Initialisez à zéro.

Remarques

N’importe quel pointeur d’élément de la structure peut avoir la valeur NULL, auquel cas le nombre correspondant doit être égal à zéro. Pour les tables d’éléments qui ne sont pas de longueur nulle, la taille de l’élément ne doit pas être inférieure à la taille de la structure d’élément correspondante définie dans le fichier d’en-tête portcls.h. La taille minimale d’un élément de propriété, d’événement ou de méthode est respectivement sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) ou sizeof(PCMETHOD_ITEM). La taille de l’élément peut être supérieure à celle-ci, auquel cas la structure de l’élément est suivie de toutes les données privées que le pilote miniport lui ajoute. Les tailles d’élément doivent être un multiple de huit.

La méthode IMiniport ::GetDescription génère une structure PCFILTER_DESCRIPTOR qui pointe vers une structure de PCAUTOMATION_TABLE qui spécifie la table d’automatisation du pilote miniport.