次の方法で共有


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

このピンの種類をインスタンス化できるグローバルな最大回数を指定します。 グローバル最大値は、アダプター ドライバーがフィルターのすべてのインスタンスでサポートできる 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構造体の配列へのポインター 含まれています。 配列内の要素の数は、フィルター内のピン ファクトリの数と等しくなります。

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

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

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

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

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

要件

要件
Header portcls.h (Portcls.h を含む)

こちらもご覧ください

IPinCount::P inCount

KSPIN_DESCRIPTOR

KSPROPERTY_PIN_CINSTANCES

KSPROPERTY_PIN_GLOBALCINSTANCES

KSPROPERTY_PIN_NECESSARYINSTANCES

PCAUTOMATION_TABLE