PCFILTER_DESCRIPTOR-Struktur (portcls.h)

Artikel
02/26/2024

Die PCFILTER_DESCRIPTOR-Struktur beschreibt die Implementierung eines Filters durch einen Miniporttreiber. Die -Struktur gibt die Pins, Knoten, Verbindungen und Eigenschaften des Filters an.

Syntax

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;

Member

Version

Reserviert. Initialisieren Sie mit 0 (null).

AutomationTable

Zeiger auf die Automatisierungstabelle. Dies ist eine Struktur vom Typ PCAUTOMATION_TABLE. Die Automatisierungstabelle gibt die Handler für die Eigenschaften der Filter instance an.

PinSize

Gibt die Größe jedes Elements im Pins-Array in Byte an. Dieser Wert sollte ein Vielfaches von acht und mindestens sizeof(PCPIN_DESCRIPTOR) sein. Bei größeren Werten können clientspezifische Deskriptorinformationen an Pindeskriptoren angefügt werden.

PinCount

Gibt die Anzahl der Stiftdeskriptoren im Pins-Array an.

Pins

Zeiger auf das Array von Stiftdeskriptoren. Jedes Arrayelement ist eine PCPIN_DESCRIPTOR-Struktur .

NodeSize

Gibt die Größe jedes Elements im Knotenarray in Byte an. Dieser Wert sollte ein Vielfaches von acht und mindestens sizeof(PCNODE_DESCRIPTOR) sein. Größere Werte ermöglichen das Anfügen clientspezifischer Deskriptorinformationen an Knotendeskriptoren.

NodeCount

Gibt die Anzahl der Knotendeskriptoren im Knotenarray an.

Nodes

Zeiger auf das Array von Knotendeskriptoren. Jedes Arrayelement ist eine PCNODE_DESCRIPTOR-Struktur .

ConnectionCount

Gibt die Anzahl der Verbindungen im Connections Array an.

Connections

Zeiger auf das Array von Verbindungsdeskriptoren. Jedes Arrayelement ist eine PCCONNECTION_DESCRIPTOR-Struktur .

CategoryCount

Gibt die Anzahl von GUIDs im Categories-Array an.

Categories

Zeiger auf das Array von GUIDs, das die Kategorien angibt, zu denen das Objekt gehört. Weitere Informationen zu Topologiekategorien finden Sie unter Installieren von Geräteschnittstellen für einen Audioadapter.

Hinweise

Ein Porttreiber ruft den Filterdeskriptor des Miniporttreibers durch Aufrufen der IMiniport::GetDescription-Methode ab. Der Filterdeskriptor ist eine PCFILTER_DESCRIPTOR Struktur, die die Pins, Knoten, Verbindungen und Eigenschaften des Miniporttreibers beschreibt. Weitere Informationen finden Sie unter Filter-, Pin- und Node-Eigenschaften.