Estructura KSTOPOLOGY (ks.h)

La estructura KSTOPOLOGY describe la topología de patillas y nodos.

Sintaxis

typedef struct {
  ULONG                       CategoriesCount;
  const GUID                  *Categories;
  ULONG                       TopologyNodesCount;
  const GUID                  *TopologyNodes;
  ULONG                       TopologyConnectionsCount;
  const KSTOPOLOGY_CONNECTION *TopologyConnections;
  const GUID                  *TopologyNodesNames;
  ULONG                       Reserved;
} KSTOPOLOGY, *PKSTOPOLOGY;

Miembros

CategoriesCount

Especifica el número de categorías funcionales que admite el controlador.

Categories

Apunta al principio de la matriz de categorías funcionales que admite el controlador.

TopologyNodesCount

Especifica el número de nodos que admite el controlador.

TopologyNodes

Apunta al principio de la matriz de GUID que describen el tipo de cada nodo. Para obtener una lista de los nodos relacionados con el streaming de kernel de vídeo, consulte Nodos de topología de streaming de kernel. Para obtener una lista de los nodos relacionados con el streaming del kernel de audio, consulte Nodos de topología de audio.

TopologyConnectionsCount

Especifica el número de entradas de la matriz a las que apunta TopologyConnections. Los números de nodo de cada entrada deben corresponder al desplazamiento de matriz del nodo dentro de TopologyNodes. Cuando esta estructura forma parte de la HW_STREAM_HEADER de un minidriver de streaming, los números de patilla deben corresponder a los desplazamientos dentro de la matriz de estructuras de HW_STREAM_INFORMATION en la estructura HW_STREAM_DESCRIPTOR del minidriver.

TopologyConnections

Apunta al principio de la matriz de conexiones de topología para esta estructura.

TopologyNodesNames

Especifica el GUID del nombre de cadena Unicode localizado para el nodo, almacenado en el Registro.

Reserved

Reservado para uso del sistema. Los controladores deben establecer esto en cero.

Comentarios

Un minidriver de clase de secuencia crea y pasa esta estructura como parte de su estructura de HW_STREAM_HEADER . El controlador de clase usa esta estructura para procesar solicitudes de propiedad de topología. Los datos de propiedad que devuelve el controlador de clase se determinan a partir de la estructura KSTOPOLOGY de la siguiente manera:

Requisitos

Requisito	Valor
Header	ks.h (incluye Ks.h)

Consulte también

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION