PCNODE_DESCRIPTOR-Struktur (portcls.h)

Artikel
02/29/2024

Die PCNODE_DESCRIPTOR-Struktur beschreibt einen Knoten im Filter, den ein Topologieminiporttreiber implementiert.

Syntax

typedef struct {
  ULONG                    Flags;
  const PCAUTOMATION_TABLE *AutomationTable;
  const GUID               *Type;
  const GUID               *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;

Member

Flags

Auf NULL festlegen. Derzeit sind keine Flagbits definiert.

AutomationTable

Zeiger auf die Automatisierungstabelle, bei der es sich um eine Struktur vom Typ PCAUTOMATION_TABLE handelt. Dieser Member kann auf NULL festgelegt werden, um keine Automatisierungsunterstützung anzugeben. Die Automatisierungstabelle gibt die Handler für die Eigenschaften und Ereignisse an, die dem Knoten instance gehören.

Type

Gibt den Knotentyp an. Dieses Element ist ein Zeiger auf eine GUID, die den Knotentyp eindeutig identifiziert. Sehen Sie sich die Liste der Knotentyp-GUIDs unter Audiotopologieknoten an.

Name

Zeiger auf eine GUID, die den Namen dieses Topologieknotens darstellt. Diese GUID wird in einer KSPROPERTY_TOPOLOGY_NAMEget-property-Anforderung angegeben, um die entsprechende Namenszeichenfolge für den Knoten abzurufen. Dieser Zeiger kann auf NULL festgelegt werden, um anzugeben, dass die GUID im Type-Element verwendet werden soll, um den Knotennamen zu bestimmen.

Hinweise

Wenn ein Filter nur einen einzelnen Knoten des Typs enthält, der vom Type-Member angegeben wird, kann das Name-Element als NULL angegeben werden, da der Type-Wert ausreicht, um den Knoten innerhalb des Filters eindeutig zu identifizieren. Wenn der Filter zwei oder mehr Knoten desselben Typs enthält, müssen die Namenselemente für diese Knoten nicht NULL sein.

Wenn ein Filter beispielsweise einen einzelnen SUM-Knoten enthält, verweist der Type-Member für diesen Knoten auf den GUID-Wert KSNODETYPE_SUM, und der Name-Member ist auf NULL festgelegt. Wenn sie nach dem Namen dieses Knotens abgefragt wird, ruft die KSPROPERTY_TOPOLOGY_NAME-Eigenschaft , nachdem festgestellt wurde, dass der Name-Wert des Knotens NULL ist, die Namenszeichenfolge aus dem Registrierungseintrag für die KSNODETYPE_SUM GUID ab. Derselbe Filter kann jedoch mehrere Volumeknoten enthalten. In diesem Fall verweisen die Type-Werte für diese Knoten alle auf denselben GUID-Wert, KSNODETYPE_VOLUME, und der Name-Wert muss jeden der Volumeknoten eindeutig identifizieren. Der Name-Wert für den Volumesteuerungsknoten für Welleneingabe sollte beispielsweise auf den GUID-Wert KSAUDFNAME_WAVE_IN_VOLUME (definiert in ksmedia.h) verweisen. Der Registrierungseintrag für diese GUID enthält die Namenszeichenfolge, die die KSPROPERTY_TOPOLOGY_NAME-Eigenschaft für den Knoten abruft.