Struttura KSTOPOLOGY (ks.h)
La struttura KSTOPOLOGY descrive la topologia di pin e 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;
Membri
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 dei nodi correlati allo streaming di kernel video, vedere nodi della topologia di streaming del kernel. Per un elenco dei nodi correlati allo streaming del kernel audio, vedere Nodi della topologia audio.
TopologyConnectionsCount
Specifica il numero di voci nella matrice a cui punta TopologyConnections. I numeri di nodo di ogni voce devono corrispondere all'offset di matrice del nodo all'interno di TopologieNodes. Quando questa struttura fa parte della HW_STREAM_HEADERdi un minidriver di streaming, i numeri dei 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 di topologia per questa struttura.
TopologyNodesNames
Specifica il GUID del nome della stringa Unicode localizzata per il nodo archiviato nel Registro di sistema.
Reserved
Riservato per l'uso del sistema. I driver devono impostare questo valore su zero.
Osservazioni
Un minidriver della classe di flusso crea e passa questa struttura come parte della 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:
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ks.h (include Ks.h) |