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 構造体から次のように決定されます。

要件

こちらもご覧ください

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION