PIN_INFO 構造体 (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

構造体には PIN_INFO 、ピンに関する情報が含まれています。

構文

typedef struct _PinInfo {
  IBaseFilter   *pFilter;
  PIN_DIRECTION dir;
  WCHAR         achName[128];
} PIN_INFO;

メンバー

pFilter

所有フィルターの IBaseFilter インターフェイスへのポインター。

dir

ピンの方向 (入力または出力)。

achName[128]

ピンの名前。

解説

出力ピンの名前がチルダ (~) で始まる場合、フィルター グラフ マネージャーはグラフを作成するときにピンを無視します。 IGraphBuilder::Connect、IGraphBuilder::Render、または IGraphBuilder::RenderFile の呼び出し中に、ピンが中間フィルターに表示される場合、フィルター グラフ マネージャーはピンをレンダリングしません。 ただし、 Connect メソッドまたは Render メソッドにピンを明示的に渡すと、ピンが レンダリング されます。

ピンが既定ではレンダリングされないセカンダリ ストリームを提供する場合、またはピンで正しくレンダリングするために特別なコードが必要な場合は、チルダを使用します。 たとえば、DVD フィルターは、サブピクチャまたはクローズド キャプション データを提供するピンに使用する必要があります。 ビデオ キャプチャ フィルターは、キャプチャ ピンに使用する必要があります (ただし、ピンをプレビューすることはできません)。

pFilter メンバーには、未処理の参照カウントがあります。 アプリケーションはインターフェイスを解放する必要があります。

要件

   
Header strmif.h (Dshow.h を含む)

関連項目

DirectShow 構造体

IPin::QueryPinInfo