PCPIN_DESCRIPTOR 構造体 (portcls.h)

[アーティクル]
02/26/2024

PCPIN_DESCRIPTOR構造では、ピンファクトリについて説明します。

構文

typedef struct {
  ULONG                    MaxGlobalInstanceCount;
  ULONG                    MaxFilterInstanceCount;
  ULONG                    MinFilterInstanceCount;
  const PCAUTOMATION_TABLE *AutomationTable;
  KSPIN_DESCRIPTOR         KsPinDescriptor;
} PCPIN_DESCRIPTOR, *PPCPIN_DESCRIPTOR;

メンバー

MaxGlobalInstanceCount

このピンの種類をインスタンス化できるグローバルな最大回数を指定します。グローバル最大値は、アダプタードライバーがフィルターのすべてのインスタンスでサポートできる pin インスタンスの数をカウントします。カウントを 0 に設定して、ピンをインスタンス化できないことを示すことができます。 ULONG(-1) の値は、ピンを何度でもインスタンス化できることを示します。その他の値は、ピンをインスタンス化できる特定の回数を示します。

MaxFilterInstanceCount

フィルターの 1 つのインスタンスでピンをインスタンス化できる最大回数を指定します。カウントを 0 に設定して、ピンをインスタンス化できないことを示すことができます。 ULONG(-1) の値は、ピンを何度でもインスタンス化できることを示します。その他の値は、ピンをインスタンス化できる特定の回数を示します。

MinFilterInstanceCount

フィルターのインスタンスでピンをインスタンス化する必要がある最小回数を指定します。このメンバーは、フィルターを機能させるために存在する必要があるピンのインスタンスの数に対する明確な下限です。

AutomationTable

オートメーションテーブルへのポインター。このメンバーは、 PCAUTOMATION_TABLE型の構造体へのポインターです。オートメーションがサポートされていないことを示す ポインターは NULL にすることができます。オートメーションテーブルは、pin インスタンスに属するプロパティとイベントのハンドラーを指定します。

KsPinDescriptor

ピンファクトリについて説明します。このメンバーは、 KSPIN_DESCRIPTOR型の構造体です。ピンファクトリには、0 個のインターフェイスと 0 個のメディアを含めることができます。すべての場合、インターフェイスの一覧は無視されます。 standard-medium リストは、デバイス I/O (KSMEDIUM_STANDARD_DEVIO) のみを含むリストに既定で設定されます。

注釈

この構造体は、ミニポートドライバーが実装する各ピンファクトリを記述するために使用されます。ドライバーの PCFILTER_DESCRIPTOR 構造体には、PCPIN_DESCRIPTOR構造体の配列へのポインターが含まれています。配列内の要素の数は、フィルター内のピンファクトリの数と等しくなります。

MaxGlobalInstanceCount、MaxFilterInstanceCount、および MinFilterInstanceCount メンバーは、ピンのリソース制限と機能要件を記述する最大および最小数です。自動初期化 されたPCPIN_DESCRIPTOR 配列では、使用可能なピンリソースの静的見積もりのみを表示できます。 IPinCount::P inCount メソッドは、ピンが割り当てられ解放されると、ドライバーが使用可能なピンリソースの一覧を動的に変更する手段を提供します。

MaxGlobalInstanceCount 値は、次のような意味です。

PinCount メソッドの GlobalPossible 呼び出しパラメーター。
KSPROPERTY_PIN_GLOBALCINSTANCES プロパティ値 (KSPIN_CINSTANCES 構造体の PossibleCount メンバー)。

MaxFilterInstanceCount 値は、次のような意味です。

PinCount メソッドの FilterPossible 呼び出しパラメーター。
KSPROPERTY_PIN_CINSTANCES プロパティ値 (KSPIN_CINSTANCES構造体の PossibleCount メンバー)。

MinFilterInstanceCount 値は、次の意味で似ています。

PinCount メソッドの FilterNecessary 呼び出しパラメーター。
KSPROPERTY_PIN_NECESSARYINSTANCES プロパティの値。

ブリッジピンを記述する場合 ( 「オーディオフィルターグラフ」を参照)、 MaxGlobalInstanceCount、 MaxFilterInstanceCount、 MinFilterInstanceCount を 0 に設定し、 AutomationTable を NULL に設定します。

PCPIN_DESCRIPTOR構造の使用方法を示す簡単なコード例については、「フィルタートポロジの公開」を参照してください。

詳細については、「ファクトリのピン留め」を参照してください。