PCNODE_DESCRIPTOR結構 （portcls.h）
PCNODE_DESCRIPTOR 結構描述拓撲迷你埠驅動程序實作之篩選中的節點。
語法
typedef struct {
ULONG Flags;
const PCAUTOMATION_TABLE *AutomationTable;
const GUID *Type;
const GUID *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;
成員
Flags
設定為零。 目前未定義旗標位。
AutomationTable
自動化數據表的指標，這是類型為 PCAUTOMATION_TABLE的結構。 這個成員可以設定為 NULL，表示沒有自動化支援。 自動化數據表會指定屬於節點實例的屬性和事件的處理程式。
Type
指定節點類型。 這個成員是可唯一識別節點類型的 GUID 指標。 請參閱 音訊拓撲節點中的節點類型 GUID 清單。
Name
代表此拓撲節點名稱之 GUID 的指標。 這個 GUID 是在 get 屬性要求中指定 KSPROPERTY_TOPOLOGY_NAME，以取得節點的對應名稱字串。 此指標可以設定為 NULL，表示 Type 成員中的 GUID 應該用來判斷節點名稱。
言論
如果篩選只包含 Type 成員所指定類型的單一節點，則可以將 Name 成員指定為 NULL，因為 Type 值足以唯一識別篩選內的節點。 如果篩選包含兩個或多個相同類型的節點，則這些節點的 名稱 成員必須是非NULL。
例如，如果篩選包含單一 SUM 節點，該節點的 Type 成員會指向 GUID 值 KSNODETYPE_SUM，且 Name 成員設定為 NULL。 當查詢該節點的名稱時，KSPROPERTY_TOPOLOGY_NAME 屬性在判斷節點的 Name 值 NULL之後，會從KSNODETYPE_SUM GUID 的登錄專案擷取名稱字元串。 不過，相同的篩選可能包含數個磁碟區節點，在此情況下，這些節點的 類型 值全都指向相同的 GUID 值，KSNODETYPE_VOLUME，而 Name 值必須唯一識別每個磁碟區節點。 例如，波輸入音量控制節點的 名稱 值應該指向 GUID 值KSAUDFNAME_WAVE_IN_VOLUME（定義於 ksmedia.h 中）。 此 GUID 的登錄專案包含節點KSPROPERTY_TOPOLOGY_NAME屬性所擷取的名稱字串。
PCFILTER_DESCRIPTOR 結構包含 PCNODE_DESCRIPTOR 結構的陣列指標。
如需示範如何使用 PCNODE_DESCRIPTOR 結構的簡單程式代碼範例，請參閱 公開篩選拓撲。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | portcls.h （包括 Portcls.h） |