struttura PCNODE_DESCRIPTOR (portcls.h)

Articolo
02/07/2025

La struttura PCNODE_DESCRIPTOR descrive un nodo nel filtro implementato da un driver miniport della topologia.

Sintassi

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

Membri

Flags

Impostare su zero. Non sono attualmente definiti bit di flag.

AutomationTable

Puntatore alla tabella di automazione, ovvero una struttura di tipo PCAUTOMATION_TABLE. Questo membro può essere impostato su NULL per indicare che non è supportato l'automazione. La tabella di automazione specifica i gestori per le proprietà e gli eventi appartenenti all'istanza del nodo.

Type

Specifica il tipo di nodo. Questo membro è un puntatore a un GUID che identifica in modo univoco il tipo di nodo. Vedere l'elenco dei GUID di tipo nodo in nodi della topologia audio.

Name

Puntatore a un GUID che rappresenta il nome di questo nodo della topologia. Questo GUID viene specificato in un KSPROPERTY_TOPOLOGY_NAMErichiesta get-property per ottenere la stringa del nome corrispondente per il nodo. Questo puntatore può essere impostato su NULL per indicare che il GUID nel membro Tipo deve essere usato per determinare il nome del nodo.

Osservazioni

Se un filtro contiene solo un singolo nodo del tipo specificato dal membro Type, il membro Name può essere specificato come NULL perché il valore Type è sufficiente per identificare in modo univoco il nodo all'interno del filtro. Se il filtro contiene due o più nodi dello stesso tipo, il Nome membri per tali nodi deve essere diverso daNULL.

Ad esempio, se un filtro contiene un singolo nodo SUM, il membro type per tale nodo punta al valore GUID KSNODETYPE_SUMe il membro Name è impostato su NULL. Quando viene eseguita una query sul nome del nodo, la proprietà KSPROPERTY_TOPOLOGY_NAME, dopo aver determinato che il valore Name del nodo è NULL, recupera la stringa del nome dalla voce del Registro di sistema per il GUID KSNODETYPE_SUM. Tuttavia, lo stesso filtro potrebbe contenere diversi nodi del volume, nel qual caso i valori di type per questi nodi puntano allo stesso valore GUID, KSNODETYPE_VOLUMEe il valore nome deve identificare in modo univoco ogni nodo del volume. Il valore nome per il nodo di controllo del volume di input onda, ad esempio, deve puntare al valore GUID KSAUDFNAME_WAVE_IN_VOLUME (definito in ksmedia.h). La voce del Registro di sistema per questo GUID contiene la stringa del nome recuperata dalla proprietà KSPROPERTY_TOPOLOGY_NAME per il nodo.