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;
Member
CategoriesCount
Gibt die Anzahl von Funktionskategorien an, die der Treiber unterstützt.
Categories
Zeigt auf den Anfang des Arrays von Funktionskategorien, das der Treiber unterstützt.
TopologyNodesCount
Gibt die Anzahl von Knoten an, die der Treiber unterstützt.
TopologyNodes
Zeigt auf den Anfang des Arrays von GUIDs, die den Typ der einzelnen Knoten beschreiben. Eine Liste der Knoten im Zusammenhang mit Videokernstreaming finden Sie unter Kernel-Streamingtopologieknoten. Eine Liste mit Audiokernstreamingknoten finden Sie unter Audiotopologieknoten.
TopologyConnectionsCount
Gibt die Anzahl der Einträge in dem Array an, auf das von TopologyConnections verwiesen wird. Die Knotennummern jedes Eintrags müssen dem Arrayoffset des Knotens in TopologyNodes entsprechen. Wenn diese Struktur Teil der HW_STREAM_HEADER eines 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
Zeigt 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
Ist für das System reserviert. Treiber sollten diesen Wert auf 0 festlegen.
Hinweise
Ein Streamklassenminidriver 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 (einschließlich Ks.h) |