Struttura KSTOPOLOGY (ks.h)
La struttura KSTOPOLOGY descrive la topologia dei pin e dei nodi.
Sintassi
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;
Members
CategoriesCount
Specifica il numero di categorie funzionali supportate dal driver.
Categories
Punta all'inizio della matrice di categorie funzionali supportate dal driver.
TopologyNodesCount
Specifica il numero di nodi supportati dal driver.
TopologyNodes
Punta all'inizio della matrice di GUID che descrivono il tipo di ogni nodo. Per un elenco di nodi correlati allo streaming del kernel video, vedere Nodi della topologia di streaming del kernel. Per un elenco di nodi correlati allo streaming del kernel audio, vedere Nodi della topologia audio.
TopologyConnectionsCount
Specifica il numero di voci nella matrice a cui punta la topologiaConnections. I numeri di nodo di ogni voce devono corrispondere all'offset della matrice del nodo all'interno di TopologiaNodes. Quando questa struttura fa parte della HW_STREAM_HEADER di un minidriver di streaming, i numeri di pin devono corrispondere agli offset all'interno della matrice di strutture HW_STREAM_INFORMATION nella struttura HW_STREAM_DESCRIPTOR del minidriver.
TopologyConnections
Punta all'inizio della matrice di connessioni della topologia per questa struttura.
TopologyNodesNames
Specifica il GUID del nome stringa Unicode localizzato per il nodo archiviato nel Registro di sistema.
Reserved
Riservato per l'utilizzo nel sistema. I driver devono impostare questo valore su zero.
Commenti
Un minidriver di classe di flusso crea e passa questa struttura come parte della relativa struttura HW_STREAM_HEADER . Il driver di classe usa questa struttura per elaborare le richieste di proprietà della topologia. I dati delle proprietà restituiti dal driver di classe vengono determinati dalla struttura KSTOPOLOGY come indicato di seguito:
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ks.h (include Ks.h) |