Structure KSTOPOLOGY (ks.h)

Article
03/05/2024

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 :