Estrutura KSTOPOLOGY (ks.h)
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:
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ks.h (inclua Ks.h) |