PCNODE_DESCRIPTOR Struktur (portcls.h)
Die PCNODE_DESCRIPTOR-Struktur beschreibt einen Knoten im Filter, den ein Topologie-Miniporttreiber implementiert.
Syntax
typedef struct {
ULONG Flags;
const PCAUTOMATION_TABLE *AutomationTable;
const GUID *Type;
const GUID *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;
Angehörige
Flags
Auf Null festgelegt. Zurzeit sind keine Flagbits definiert.
AutomationTable
Zeiger auf die Automatisierungstabelle, bei der es sich um eine Struktur vom Typ PCAUTOMATION_TABLEhandelt. Dieses Element kann auf NULL- festgelegt werden, um keine Automatisierungsunterstützung anzugeben. Die Automatisierungstabelle gibt die Handler für die Eigenschaften und Ereignisse an, die zur Knoteninstanz gehören.
Type
Gibt den Knotentyp an. Dieses Element ist ein Zeiger auf eine GUID, die den Knotentyp eindeutig identifiziert. Siehe die Liste der GuiDs vom Typ Node in Audiotopologieknoten.
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 Member verwendet werden soll, um den Knotennamen zu bestimmen.
Bemerkungen
Wenn ein Filter nur einen einzelnen Knoten des Typs enthält, der durch den Type Member angegeben wird, kann der Name Member als NULL- angegeben werden, da der wert Type ausreicht, um den Knoten innerhalb des Filters eindeutig zu identifizieren. Wenn der Filter zwei oder mehr Knoten desselben Typs enthält, muss der Name Member für diese Knoten nichtNULL-sein.
Wenn z. B. ein Filter einen einzelnen SUMME-Knoten enthält, verweist der Typ Element für diesen Knoten auf den GUID-Wert KSNODETYPE_SUM, und das Name Member wird auf NULL-festgelegt. Wenn der Name dieses Knotens abgefragt wird, ruft die KSPROPERTY_TOPOLOGY_NAME-Eigenschaft nach dem Bestimmen, 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 zeigen die werte Type für diese Knoten alle auf den gleichen GUID-Wert, KSNODETYPE_VOLUMEund der wert Name muss jeden Volumeknoten eindeutig identifizieren. Der Name Werts für den Welleneingabelautstärkensteuerungsknoten sollte z. B. auf den GUID-Wert KSAUDFNAME_WAVE_IN_VOLUME (definiert in ksmedia.h) verweisen. Der Registrierungseintrag für diese GUID enthält die Namenszeichenfolge, die von der KSPROPERTY_TOPOLOGY_NAME-Eigenschaft für den Knoten abgerufen wird.
Die PCFILTER_DESCRIPTOR-Struktur enthält einen Zeiger auf ein Array von PCNODE_DESCRIPTOR Strukturen.
Ein einfaches Codebeispiel, das zeigt, wie die PCNODE_DESCRIPTOR-Struktur verwendet wird, finden Sie unter Verfügbarmachen der Filtertopologie.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | portcls.h (include Portcls.h) |