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) |