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