structure PCFILTER_DESCRIPTOR (portcls.h)

Article
02/26/2024

La structure PCFILTER_DESCRIPTOR décrit l’implémentation d’un filtre par un pilote miniport. La structure spécifie les broches, les nœuds, les connexions et les propriétés du filtre.

Syntaxe

typedef struct {
  ULONG                         Version;
  const PCAUTOMATION_TABLE      *AutomationTable;
  ULONG                         PinSize;
  ULONG                         PinCount;
  const PCPIN_DESCRIPTOR        *Pins;
  ULONG                         NodeSize;
  ULONG                         NodeCount;
  const PCNODE_DESCRIPTOR       *Nodes;
  ULONG                         ConnectionCount;
  const PCCONNECTION_DESCRIPTOR *Connections;
  ULONG                         CategoryCount;
  const GUID                    *Categories;
} PCFILTER_DESCRIPTOR, *PPCFILTER_DESCRIPTOR;

Membres

Version

Réservé. Initialisez à zéro.

AutomationTable

Pointeur vers la table Automation. Il s’agit d’une structure de type PCAUTOMATION_TABLE. La table Automation spécifie les gestionnaires pour les propriétés du filtre instance.

PinSize

Spécifie la taille en octets de chaque élément du tableau Pins . Cette valeur doit être un multiple de huit et doit être d’au moins sizeof(PCPIN_DESCRIPTOR). Les valeurs plus grandes permettent d’ajouter des informations de descripteur spécifiques au client aux descripteurs d’épingle.

PinCount

Spécifie le nombre de descripteurs de broches dans le tableau Pins .

Pins

Pointeur vers le tableau de descripteurs de broches. Chaque élément de tableau est une structure PCPIN_DESCRIPTOR .

NodeSize

Spécifie la taille en octets de chaque élément du tableau Nœuds . Cette valeur doit être un multiple de huit et doit être au moins sizeof(PCNODE_DESCRIPTOR). Les valeurs plus grandes permettent d’ajouter des informations de descripteur spécifiques au client aux descripteurs de nœud.

NodeCount

Spécifie le nombre de descripteurs de nœuds dans le tableau Nœuds .

Nodes

Pointeur vers le tableau de descripteurs de nœuds. Chaque élément de tableau est une structure PCNODE_DESCRIPTOR .

ConnectionCount

Spécifie le nombre de connexions dans le tableau Connections.

Connections

Pointeur vers le tableau de descripteurs de connexions. Chaque élément de tableau est une structure PCCONNECTION_DESCRIPTOR .

CategoryCount

Spécifie le nombre d’GUID dans le tableau Catégories .

Categories

Pointeur vers le tableau de GUID qui spécifie les catégories auxquelles l’objet appartient. Consultez la discussion sur les catégories de topologie dans Installation d’interfaces d’appareil pour une carte audio.

Remarques

Un pilote de port obtient le descripteur de filtre du pilote miniport en appelant la méthode IMiniport ::GetDescription . Le descripteur de filtre est une structure PCFILTER_DESCRIPTOR décrivant les broches, les nœuds, les connexions et les propriétés du pilote miniport. Pour plus d’informations, consultez Propriétés de filtre, d’épingle et de nœud.