次の方法で共有

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 の配列の先頭を指します。 ビデオ カーネル ストリーミング関連ノードの一覧については、「カーネル ストリーミング トポロジ ノード」を参照してください。 オーディオ カーネル ストリーミング関連ノードの一覧については、「Audio Topology Nodes」を参照してください。

TopologyConnectionsCount

TopologyConnectionsが指す配列内のエントリの数を指定します。 各エントリのノード番号は、TopologyNodes内のノードの配列オフセットに対応している必要があります。 この構造体がストリーミング ミニドライバーの HW_STREAM_HEADERの一部である場合、ピン番号は、ミニドライバーの HW_STREAM_DESCRIPTOR 構造体の HW_STREAM_INFORMATION 構造体の配列内のオフセットに対応する必要があります。

TopologyConnections

この構造体のトポロジ接続の配列の先頭を指します。

TopologyNodesNames

レジストリに格納されているノードのローカライズされた Unicode 文字列名の GUID を指定します。

Reserved

システム用に予約されています。 ドライバーはこれを 0 に設定する必要があります。

備考

ストリーム クラス ミニドライバーは、HW_STREAM_HEADER 構造体の一部としてこの構造体を作成して渡します。 クラス ドライバーは、この構造体を使用してトポロジ プロパティの要求を処理します。 クラス ドライバーが返すプロパティ データは、KSTOPOLOGY 構造体から次のように決定されます。

必要条件

要件 価値
ヘッダー ks.h (Ks.h を含む)

関連項目

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION