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 du noyau vidéo, consultez nœuds de topologie de diffusion en continu du noyau. Pour obtenir la liste des nœuds liés à la diffusion en continu du noyau audio, consultez nœuds de topologie audio.
TopologyConnectionsCount
Spécifie le nombre d’entrées dans le tableau pointé par TopologieConnections. 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_HEADERd’un minidriver de diffusion en continu, les numéros d’épingle doivent correspondre aux décalages dans le 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é à l’utilisation du 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 :
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ks.h (include Ks.h) |