Estrutura KSTOPOLOGY (ks.h)

Artigo
02/26/2024

A estrutura KSTOPOLOGY descreve a topologia de pinos e nós.

Sintaxe

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;

Membros

CategoriesCount

Especifica o número de categorias funcionais às quais o driver dá suporte.

Categories

Aponta para o início da matriz de categorias funcionais às quais o driver dá suporte.

TopologyNodesCount

Especifica o número de nós aos quais o driver dá suporte.

TopologyNodes

Aponta para o início da matriz de GUIDs que descrevem o tipo de cada nó. Para obter uma lista de nós relacionados ao streaming de kernel de vídeo, consulte Nós de topologia de streaming de kernel. Para obter uma lista de nós relacionados ao streaming de kernel de áudio, consulte Nós de topologia de áudio.

TopologyConnectionsCount

Especifica o número de entradas na matriz apontada por TopologyConnections. Os números de nó de cada entrada devem corresponder ao deslocamento de matriz do nó em TopologyNodes. Quando essa estrutura faz parte do HW_STREAM_HEADER de um minidriver de streaming, os números de pino devem corresponder aos deslocamentos dentro da matriz de estruturas de HW_STREAM_INFORMATION na estrutura de HW_STREAM_DESCRIPTOR do minidriver.

TopologyConnections

Aponta para o início da matriz de conexões de topologia para essa estrutura.

TopologyNodesNames

Especifica o GUID do nome da cadeia de caracteres Unicode localizada para o nó, armazenado no registro.

Reserved

Reservado para uso do sistema. Os drivers devem definir isso como zero.

Comentários

Um minidriver de classe de fluxo cria e passa essa estrutura como parte de sua estrutura de HW_STREAM_HEADER . O driver de classe usa essa estrutura para processar solicitações de propriedade de topologia. Os dados de propriedade que o driver de classe retorna são determinados da estrutura KSTOPOLOGY da seguinte maneira: