次の方法で共有

PCPIN_DESCRIPTOR構造体 (portcls.h)

  • [アーティクル]

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

構文

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

メンバーズ

MaxGlobalInstanceCount

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

MaxFilterInstanceCount

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

MinFilterInstanceCount

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

AutomationTable

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

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 値は、次のような意味です。

MaxFilterInstanceCount 値は、次のような意味です。
  • PinCount メソッドの FilterPossible 呼び出しパラメーター。
  • KSPROPERTY_PIN_CINSTANCES プロパティ値 (KSPIN_CINSTANCES構造体の PossibleCount メンバー)。
MinFilterInstanceCount 値は、次のような意味です。 ブリッジ ピンを記述する場合 (オーディオ フィルター グラフを参照)、MaxGlobalInstanceCount 、MaxFilterInstanceCount、および MinFilterInstanceCountをゼロに設定し、AutomationTable を NULL に設定します。

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

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

必要条件

要件 価値
ヘッダー portcls.h (Portcls.h を含む)

関連項目

IPinCount::P inCount

KSPIN_DESCRIPTOR

KSPROPERTY_PIN_CINSTANCES

KSPROPERTY_PIN_GLOBALCINSTANCES

KSPROPERTY_PIN_NECESSARYINSTANCES

PCAUTOMATION_TABLE