IPinCount::P inCount メソッド (portcls.h)

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

メソッドは PinCount 、ミニポートドライバーのピン数を照会します。

構文

void PinCount(
  [in]      ULONG  PinId,
  [in, out] PULONG FilterNecessary,
  [in, out] PULONG FilterCurrent,
  [in, out] PULONG FilterPossible,
  [in, out] PULONG GlobalCurrent,
  [in, out] PULONG GlobalPossible
);

パラメーター

[in] PinId

ピン ID を指定します。フィルターに n 個のピンファクトリが含まれている場合、有効なピン ID の範囲は 0 から n-1 です。

[in, out] FilterNecessary

フィルターが I/O 操作を実行する前に、ピンファクトリがインスタンス化する必要があるピンの最小数を指定します。

[in, out] FilterCurrent

ピンインスタンスの現在の数を指定します。この数は、ピンファクトリがフィルターで既にインスタンス化したピンをカウントします。

[in, out] FilterPossible

ピンファクトリがフィルターでインスタンス化できるピンの最大数を指定します。最大値がない場合は、KSINSTANCE_INDETERMINATEに設定します。

[in, out] GlobalCurrent

ドライバーでピンファクトリがインスタンス化したピンの現在の数を指定します。

[in, out] GlobalPossible

ドライバーでピンファクトリがインスタンス化できるピンの最大数を指定します。最大値がない場合は、KSINSTANCE_INDETERMINATEに設定します。

戻り値

なし

解説

呼び出しには PinCount 、次の 2 つの目的があります。

ミニポートドライバーに現在のピン数を知らせるために。
ミニポートドライバーに現在のピン数を変更する機会を与える。

FilterNecessary、 FilterCurrent、 FilterPossible、 GlobalCurrent、 GlobalPossible はすべて、ミニポートドライバーのフィルターの説明の値を指す IN+OUT パラメーターです。 PinCount 呼び出し中、ミニポートドライバーはこれらの値を調べることができ、残りのリソースから作成できる追加ピンの数をより正確に示すために、値を編集するオプションがあります。

FilterCurrent と FilterPossible は、 PinId で指定されたピンファクトリのフィルターごとの値を指定します。

GlobalCurrent と GlobalPossible は、フィルターのすべてのインスタンスに対するピンファクトリの合計値を指定します。

ミニポートドライバーは通常 、FilterNecessary パラメーターを変更する必要はありませんが、完全性のために含まれています。

IPort::Init 呼び出し中、ポートドライバーはミニポートドライバーの IMiniport::GetDescription メソッドを呼び出して、ミニポートドライバーの pin 記述子配列を含むフィルター記述子へのポインターを取得します (「PCPIN_DESCRIPTOR」を参照)。その後、ポートドライバーは、pin プロパティのクエリに応答するピン記述子にアクセスします。

ミニポートドライバーが IPinCount インターフェイスをサポートしている場合、ポートドライバーはを呼び出 PinCount して、ミニポートドライバーに pin プロパティ要求に応答する前にピン数を更新する機会を与えます。ミニポートドライバーが IPinCount をサポートしていない場合、ポートドライバーは、単に pin 記述子配列の静的なピン数の制限を使用します。

ポートドライバーは、 PinCount 次の KS プロパティ要求のいずれかを受信すると、メソッドを呼び出します。

KSPROPERTY_PIN_CINSTANCES

KSPROPERTY_PIN_GLOBALCINSTANCES

KSPROPERTY_PIN_NECESSARYINSTANCES

PortCls では、新しいストリームが PinCount 作成されるたびにメソッドも呼び出されます。

ミニポートドライバーは、メソッド内からストリームを作成または破棄することを明示的に PinCount 発生させてはいけません。ミニポートドライバーは、この呼び出し中に何ができるかに制限されません。

メソッドは PinCount IRQL PASSIVE_LEVELで呼び出されます。このメソッドのコードは、ページメモリ内に存在する必要があります。