struttura PCNODE_DESCRIPTOR (portcls.h)

Articolo
08/07/2023

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;

Members

Flags

Imposta 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 nessun supporto di 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 nei nodi della topologia audio.

Name

Puntatore a un GUID che rappresenta il nome di questo nodo della topologia. Questo GUID viene specificato in una 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 Type deve essere usato per determinare il nome del nodo.

Commenti

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, i membri Name per tali nodi devono essere diversi da NULL.

Ad esempio, se un filtro contiene un singolo nodo SUM, il membro Type per tale nodo punta al valore GUID KSNODETYPE_SUM e il membro Name è impostato su NULL. Quando viene eseguita una query per il 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 più nodi del volume, nel qual caso i valori Type per questi nodi puntano tutti allo stesso valore GUID, KSNODETYPE_VOLUME e il valore Name deve identificare in modo univoco ognuno dei nodi del volume. Il valore Name per il nodo di controllo del volume di input wave, 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 di nome recuperata dalla proprietà KSPROPERTY_TOPOLOGY_NAME per il nodo.