KSTOPOLOGY 構造体 (ks.h)
KSTOPOLOGY 構造では、ピンとノードのトポロジについて説明します。
構文
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;
メンバー
CategoriesCount
ドライバーがサポートする機能カテゴリの数を指定します。
Categories
ドライバーがサポートする機能カテゴリの配列の先頭を指します。
TopologyNodesCount
ドライバーがサポートするノードの数を指定します。
TopologyNodes
各ノードの種類を記述する GUID の配列の先頭を指します。 ビデオ カーネル ストリーミング関連ノードの一覧については、「 カーネル ストリーミング トポロジ ノード」を参照してください。 オーディオ カーネル ストリーミング関連ノードの一覧については、「 オーディオ トポロジ ノード」を参照してください。
TopologyConnectionsCount
TopologyConnections が指す配列内のエントリの数を指定します。 各エントリのノード番号は、 TopologyNodes 内のノードの配列オフセットに対応している必要があります。 この構造体がストリーミング ミニドライバーのHW_STREAM_HEADERの一部である場合、ピン番号は、ミニドライバーのHW_STREAM_DESCRIPTOR構造体内のHW_STREAM_INFORMATION構造体の配列内のオフセットに対応する必要があります。
TopologyConnections
この構造体のトポロジ接続の配列の先頭を指します。
TopologyNodesNames
レジストリに格納されているノードのローカライズされた Unicode 文字列名の GUID を指定します。
Reserved
システムで使用するために予約されています。 ドライバーはこれを 0 に設定する必要があります。
注釈
ストリーム クラス ミニドライバーは、この構造体を作成し、 そのHW_STREAM_HEADER 構造の一部として渡します。 クラス ドライバーは、この構造体を使用してトポロジ プロパティの要求を処理します。 クラス ドライバーが返すプロパティ データは、KSTOPOLOGY 構造体から次のように決定されます。
要件
| 要件 | 値 |
|---|---|
| Header | ks.h (Ks.h を含む) |