estructura PCNODE_DESCRIPTOR (portcls.h)
La estructura PCNODE_DESCRIPTOR describe un nodo en el filtro que implementa un controlador de miniporte de topología.
Sintaxis
typedef struct {
ULONG Flags;
const PCAUTOMATION_TABLE *AutomationTable;
const GUID *Type;
const GUID *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;
Miembros
Flags
Establézcalo en cero. Actualmente no se definen bits de marca.
AutomationTable
Puntero a la tabla de automatización, que es una estructura de tipo PCAUTOMATION_TABLE. Este miembro se puede establecer en NULL para indicar que no se admite la automatización. La tabla de automatización especifica los controladores de las propiedades y eventos que pertenecen a la instancia del nodo.
Type
Especifica el tipo de nodo. Este miembro es un puntero a un GUID que identifica de forma única el tipo de nodo. Consulte la lista de GUID de tipo nodo en nodos de topología de audio.
Name
Puntero a un GUID que representa el nombre de este nodo de topología. Este GUID se especifica en un KSPROPERTY_TOPOLOGY_NAMEsolicitud get-property para obtener la cadena de nombre correspondiente para el nodo. Este puntero se puede establecer en NULL para indicar que el GUID del miembro type debe usarse para determinar el nombre del nodo.
Observaciones
Si un filtro contiene solo un solo nodo del tipo especificado por el miembro Type de, el miembro Name se puede especificar como NULL porque el valor Type de es suficiente para identificar de forma única el nodo dentro del filtro. Si el filtro contiene dos o más nodos del mismo tipo, los miembros de Name para esos nodos deben serNULL.
Por ejemplo, si un filtro contiene un único nodo SUM, el miembro Type de type para ese nodo apunta al valor GUID KSNODETYPE_SUMy el miembro Name está establecido en NULL. Cuando se consulta el nombre de ese nodo, la propiedad KSPROPERTY_TOPOLOGY_NAME, después de determinar que el nombre del nodo valor es NULL, recupera la cadena de nombre de la entrada del Registro para el GUID de KSNODETYPE_SUM. Sin embargo, el mismo filtro puede contener varios nodos de volumen, en cuyo caso los valores de Type para estos nodos apuntan al mismo valor GUID, KSNODETYPE_VOLUMEy el Nombre valor deben identificar de forma única cada uno de los nodos de volumen. El Nombre valor del nodo de control de volumen de entrada de onda, por ejemplo, debe apuntar al valor GUID KSAUDFNAME_WAVE_IN_VOLUME (definido en ksmedia.h). La entrada del Registro para este GUID contiene la cadena de nombre que recupera la propiedad KSPROPERTY_TOPOLOGY_NAME para el nodo.
La estructura PCFILTER_DESCRIPTOR contiene un puntero a una matriz de estructuras PCNODE_DESCRIPTOR.
Para ver un ejemplo de código sencillo que muestra cómo se usa la estructura de PCNODE_DESCRIPTOR, vea Exposing Filter Topology.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | portcls.h (incluya Portcls.h) |