KSTOPOLOGY-Struktur (ks.h)
Die KSTOPOLOGY-Struktur beschreibt die Topologie von Pins und Knoten.
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;
Angehörige
CategoriesCount
Gibt die Anzahl der Funktionskategorien an, die der Treiber unterstützt.
Categories
Verweist auf den Anfang des Arrays von Funktionskategorien, die der Treiber unterstützt.
TopologyNodesCount
Gibt die Anzahl der Knoten an, die der Treiber unterstützt.
TopologyNodes
Verweist auf den Anfang des Arrays von GUIDs, die den Typ der einzelnen Knoten beschreiben. Eine Liste der im Zusammenhang mit dem Videokernstreaming verbundenen Knoten finden Sie unter Kernel Streaming Topology Nodes. Eine Liste der im Zusammenhang mit dem Audiokernstreaming verbundenen Knoten finden Sie unter Audiotopologieknoten.
TopologyConnectionsCount
Gibt die Anzahl der Einträge im Array an, auf die durch TopologyConnectionsverwiesen wird. Die Knotennummern jedes Eintrags müssen dem Arrayoffset des Knotens innerhalb TopologyNodesentsprechen. Wenn diese Struktur Teil der HW_STREAM_HEADEReines Streaming-Minidrivers ist, müssen die Pinnummern den Offsets innerhalb des Arrays HW_STREAM_INFORMATION Strukturen in der HW_STREAM_DESCRIPTOR Struktur des Minidrivers entsprechen.
TopologyConnections
Verweist auf den Anfang des Arrays von Topologieverbindungen für diese Struktur.
TopologyNodesNames
Gibt die GUID des lokalisierten Unicode-Zeichenfolgennamens für den Knoten an, der in der Registrierung gespeichert ist.
Reserved
Reserviert für die Systemverwendung. Treiber sollten dies auf Null festlegen.
Bemerkungen
Ein Streamklassen-Minidriver erstellt und übergibt diese Struktur als Teil der HW_STREAM_HEADER Struktur. Der Klassentreiber verwendet diese Struktur, um Topologieeigenschaftenanforderungen zu verarbeiten. Die Vom Klassentreiber zurückgegebenen Eigenschaftendaten werden wie folgt aus der KSTOPOLOGY-Struktur bestimmt:
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |