Structure KSTOPOLOGY (ks.h)
La structure KSTOPOLOGY décrit la topologie des broches et des nœuds.
Syntaxe
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;
Membres
CategoriesCount
Spécifie le nombre de catégories fonctionnelles prises en charge par le pilote.
Categories
Pointe vers le début du tableau de catégories fonctionnelles prises en charge par le pilote.
TopologyNodesCount
Spécifie le nombre de nœuds pris en charge par le pilote.
TopologyNodes
Pointe vers le début du tableau de GUID qui décrivent le type de chaque nœud. Pour obtenir la liste des nœuds liés à la diffusion en continu de noyau vidéo, consultez Nœuds de topologie de streaming de noyau. Pour obtenir la liste des nœuds liés au streaming de noyau audio, consultez Nœuds de topologie audio.
TopologyConnectionsCount
Spécifie le nombre d’entrées dans le tableau pointé vers topologyConnections. Les numéros de nœud de chaque entrée doivent correspondre au décalage de tableau du nœud dans TopologyNodes. Lorsque cette structure fait partie de la HW_STREAM_HEADER d’un minidriver de diffusion en continu, les numéros d’épingle doivent correspondre aux décalages au sein du tableau de structures HW_STREAM_INFORMATION dans la structure HW_STREAM_DESCRIPTOR du minidriver.
TopologyConnections
Pointe vers le début du tableau de connexions de topologie pour cette structure.
TopologyNodesNames
Spécifie le GUID du nom de chaîne Unicode localisé pour le nœud, stocké dans le Registre.
Reserved
Réservé pour le système. Les pilotes doivent définir cette valeur sur zéro.
Remarques
Un minidriver de classe de flux crée et transmet cette structure dans le cadre de sa structure HW_STREAM_HEADER . Le pilote de classe utilise cette structure pour traiter les demandes de propriétés de topologie. Les données de propriété retournées par le pilote de classe sont déterminées à partir de la structure KSTOPOLOGY comme suit :
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ks.h (inclure Ks.h) |