PCFILTER_DESCRIPTOR 構造体 (portcls.h)

[アーティクル]
08/07/2023

PCFILTER_DESCRIPTOR構造体は、ミニポートドライバーのフィルターの実装について説明します。構造体は、フィルターのピン、ノード、接続、およびプロパティを指定します。

構文

typedef struct {
  ULONG                         Version;
  const PCAUTOMATION_TABLE      *AutomationTable;
  ULONG                         PinSize;
  ULONG                         PinCount;
  const PCPIN_DESCRIPTOR        *Pins;
  ULONG                         NodeSize;
  ULONG                         NodeCount;
  const PCNODE_DESCRIPTOR       *Nodes;
  ULONG                         ConnectionCount;
  const PCCONNECTION_DESCRIPTOR *Connections;
  ULONG                         CategoryCount;
  const GUID                    *Categories;
} PCFILTER_DESCRIPTOR, *PPCFILTER_DESCRIPTOR;

メンバー

Version

予約済み。 0 に初期化します。

AutomationTable

オートメーションテーブルへのポインター。これは、 PCAUTOMATION_TABLE型の構造体です。オートメーションテーブルでは、フィルターインスタンスのプロパティのハンドラーを指定します。

PinSize

Pins 配列内の各要素のサイズをバイト単位で指定します。この値は 8 の倍数で、少なくとも sizeof(PCPIN_DESCRIPTOR) である必要があります。値を大きくすると、クライアント固有の記述子情報をピン記述子に追加できます。

PinCount

Pin 配列内のピン記述子の数を指定します。

Pins

ピン記述子の配列へのポインター。各配列要素は、PCPIN_DESCRIPTOR 構造体です。

NodeSize

Nodes 配列内の各要素のサイズをバイト単位で指定します。この値は 8 の倍数で、少なくとも sizeof(PCNODE_DESCRIPTOR) である必要があります。値を大きくすると、クライアント固有の記述子情報をノード記述子に追加できます。

NodeCount

Nodes 配列内のノード記述子の数を指定します。

Nodes

ノード記述子の配列へのポインター。各配列要素は、PCNODE_DESCRIPTOR 構造体です。

ConnectionCount

Connections配列内の接続の数を指定します。

Connections

接続記述子の配列へのポインター。各配列要素は、PCCONNECTION_DESCRIPTOR 構造体です。

CategoryCount

Categories 配列内の GUID の数を指定します。

Categories

オブジェクトが属するカテゴリを指定する GUID の配列へのポインター。「オーディオアダプターのデバイスインターフェイスのインストール」のトポロジカテゴリの説明を参照してください。

注釈

ポートドライバーは、 IMiniport::GetDescription メソッドを呼び出すことによって、ミニポートドライバーのフィルター記述子を取得します。フィルター記述子 は、ミニポート ドライバーのピン、ノード、接続、およびプロパティを記述するPCFILTER_DESCRIPTOR構造体です。詳細については、「フィルター、ピン留め、およびノードのプロパティ」を参照してください。