estructura PCNODE_DESCRIPTOR (portcls.h)

La estructura de 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

Establecer en cero. Actualmente no hay bits de marca definidos.

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.

Comentarios

Si un filtro contiene solo un nodo del tipo especificado por el miembro Type , el miembro Name se puede especificar como NULL porque el valor type 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 Name de esos nodos deben ser no NULL.

Por ejemplo, si un filtro contiene un único nodo SUM, el miembro Type de ese nodo apunta al valor GUID KSNODETYPE_SUM y el miembro Name se establece en NULL. Cuando se consulta el nombre de ese nodo, la propiedad KSPROPERTY_TOPOLOGY_NAME , después de determinar que el valor name del nodo 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 type de estos nodos apuntan al mismo valor GUID, KSNODETYPE_VOLUME y el valor Name debe identificar de forma única cada uno de los nodos de volumen. El valor Name 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 de 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 Exponer topología de filtro.

Requisitos

Requisito	Valor
Header	portcls.h (incluir Portcls.h)

Consulte también

KSPROPERTY_TOPOLOGY_NAME

PCAUTOMATION_TABLE

PCFILTER_DESCRIPTOR