KSTOPOLOGY structure

The KSTOPOLOGY structure describes the topology of pins and nodes.

Syntax


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;

Members

CategoriesCount

Specifies the number of functional categories that the driver supports.

Categories

Points to the beginning of the array of functional categories that the driver supports.

TopologyNodesCount

Specifies the number of nodes that the driver supports.

TopologyNodes

Points to the beginning of the array of GUIDs that describe the type of each node. For a list of video kernel streaming related nodes, see Kernel Streaming Topology Nodes. For a list of audio kernel streaming related nodes, see Audio Topology Nodes.

TopologyConnectionsCount

Specifies the number of entries in the array pointed to by TopologyConnections. The node numbers of each entry must correspond to the array offset of the node within TopologyNodes. When this structure is a part of a streaming minidriver's HW_STREAM_HEADER, the pin numbers must correspond to the offsets within the array of HW_STREAM_INFORMATION structures in the minidriver's HW_STREAM_DESCRIPTOR structure.

TopologyConnections

Points to the beginning of the array of topology connections for this structure.

TopologyNodesNames

Specifies the GUID of the localized Unicode string name for the node, stored in the registry.

Reserved

Reserved for system use. Drivers should set this to zero.

Remarks

A stream class minidriver creates and passes this structure as part of its HW_STREAM_HEADER structure. The class driver uses this structure to process topology property requests. The property data that the class driver returns is determined from the KSTOPOLOGY structure as follows:

KSPROPERTY_TOPOLOGY_CATEGORIES

Returns the array that begins at the Categories member of KSTOPOLOGY.

KSPROPERTY_TOPOLOGY_CONNECTIONS

Returns the array that begins at the TopologyConnections member of KSTOPOLOGY.

KSPROPERTY_TOPOLOGY_NAME
KSPROPERTY_TOPOLOGY_NODES

Returns the array that begins at the Nodes member of KSTOPOLOGY.

Requirements

Header

Ks.h (include Ks.h)

See also

HW_STREAM_HEADER
HW_STREAM_INFORMATION
HW_STREAM_DESCRIPTOR
KSTOPOLOGY_CONNECTION

 

 

Send comments about this topic to Microsoft

Show: