次の方法で共有


IPinCount インターフェイス (portcls.h)

IPinCount インターフェイスは、ミニポート ドライバーが監視し、ピンがインスタンス化され、閉じると、そのピンの数を動的に操作するための手段を提供します。 このインターフェイスは、ミニポート ドライバーに実装されます。 ミニポート ドライバーがこのインターフェイスをサポートしているかどうかを判断するには、ポート ドライバーは、REFIID IID_IPinCountを持つミニポート オブジェクトの QueryInterface メソッドを呼び出します。 IPinCount は、IUnknown インターフェイスから継承します。

ミニポート ドライバーが実装する場合、次のポート ドライバーは、ミニポート ドライバーの IPinCount インターフェイスを使用します: WaveCyclic、WavePci、MIDI、DMus、トポロジ。

IPinCount は、ミニポート ドライバーが次のいずれかまたは両方を行う必要がある場合にサポートできる省略可能なインターフェイスです。

  • カーネル ストリーミングピン数の変更を明示的に通知する。
  • ピン数を動的に変更します。
たとえば、ウェーブ オーディオ デバイスの場合、さまざまな属性 (3D、ステレオ/モノラルなど) を持つストリームでも、消費するハードウェア リソースの量に関して異なる "重み" が設定される可能性があります。

"ヘビーウェイト" ストリームを開くときに、ミニポート ドライバーは、残りのリソースを使用して作成できるピンの数をより正確に示すために、使用可能なピン数を 1 つではなく 2 つ減らす必要がある場合があります。

"heavyweight" ストリームが閉じられると、プロセスが逆になります。 新しく解放されたリソースから 2 つ以上の "軽量" ストリームを作成できることを反映するために、使用可能なピン数が複数増加する可能性があります。

ミニポート ドライバーが IPinCount インターフェイスをサポートしていない場合、ポート ドライバーは、フィルターの PCPIN_DESCRIPTOR 配列で静的に初期化されたピン数を使用します。

IPinCount インターフェイスには、1 つのメソッドが用意されています。 ミニポート ドライバーにバインドされているポート ドライバーは、ピンカウント クエリに応答してこのメソッドを呼び出します。

継承

IPinCount インターフェイスは、IUnknown インターフェイスから継承します。

メソッド

IPinCount インターフェイスには、これらのメソッドがあります。

 
IPinCount::P inCount

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

必要条件

要件 価値
ターゲット プラットフォーム ウィンドウズ
ヘッダー portcls.h