PIN_INFO 構造体

  • [アーティクル]

PIN_INFO 構造体には、ピンに関する情報が格納される。

構文

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

メンバ

pFilter

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

dir

ピンの方向 (入力/出力)。

achName

ピンの名前。

注意

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

デフォルトではレンダリングされないセカンダリ ストリームを渡すピンや、正しくレンダリングするために特殊なコードが必要になるピンにはチルダ (~) を使う。たとえば、DVD フィルタでは、サブピクチャまたはクローズド キャプション データを渡すピンに使う。また、ビデオ キャプチャ フィルタでは、キャプチャ ピン (ただし、プレビュー ピン以外) に使う。

pFilter メンバに未処理の参照カウントが残る。アプリケーションはそのインターフェイスを解放しなければならない。

参照