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 是在 KSPROPERTY_TOPOLOGY_NAMEget 屬性要求中指定，以取得節點的對應名稱字串。 這個指標可以設定為 NULL ，表示 Type 成員中的 GUID 應該用來判斷節點名稱。

備註

如果篩選只包含 Type 成員所指定類型的單一節點，則可以將 Name 成員指定為 NULL ，因為 Type 值足以唯一識別篩選內的節點。 如果篩選包含兩個或多個相同類型的節點，則這些節點的 Name 成員必須是非 NULL。

例如，如果篩選包含單一 SUM 節點，該節點的 Type 成員會 指向 GUID 值KSNODETYPE_SUM，而 Name 成員會設定為 NULL。 查詢該節點的名稱時， KSPROPERTY_TOPOLOGY_NAME 屬性在判斷節點的 Name 值為 NULL 之後，從KSNODETYPE_SUM GUID 的登錄專案中擷取名稱字串。 不過，相同的篩選可能包含數個磁碟區節點，在此情況下，這些節點的 Type 值全都指向相同的 GUID 值 ，KSNODETYPE_VOLUME， 而 Name 值必須唯一識別每個磁碟區節點。 例如，波浪輸入磁碟區控制節點的 Name 值應該指向 ksmedia.h) 中定義的 GUID 值KSAUDFNAME_WAVE_IN_VOLUME (。 此 GUID 的登錄專案包含節點KSPROPERTY_TOPOLOGY_NAME屬性擷取的名稱字串。

PCFILTER_DESCRIPTOR 結構包含PCNODE_DESCRIPTOR結構的陣列指標。

如需示範 如何使用PCNODE_DESCRIPTOR 結構的簡單程式代碼範例，請參閱 公開篩選拓撲。

規格需求

需求	值
標頭	portcls.h (包含 Portcls.h)

另請參閱

KSPROPERTY_TOPOLOGY_NAME

PCAUTOMATION_TABLE

PCFILTER_DESCRIPTOR