次の方法で共有

IBaseFilter::FindPin

  • [アーティクル]

FindPin メソッドは、指定した識別子でピンを取得する。

構文

  HRESULT FindPin(
  LPCWSTR Id,
  IPin **ppPin
);

パラメータ

Id

[in] ピンを示す定数のワイド キャラクタ文字列へのポインタ。IPin::QueryId を呼び出してピンの識別子を取得すること。

ppPin

[out] ピンの IPin インターフェイスへのポインタを受け取る変数のアドレス。メソッドが失敗すると、*ppPin は NULL に設定される。

戻り値

HRESULT 値を返す。可能な値は次のとおりである。

戻りコード 説明
S_OK 成功。
E_POINTER NULL ポインタ引数。
VFW_E_NOT_FOUND この識別子を持つピンを見つけることができなかった。

注意

このメソッドはグラフの永続性をサポートする。IPin::QueryId メソッドを使ってピンの状態をセーブし、このメソッドを使って状態を復元すること。ピンの識別子文字列はフィルタ実装によって定義される。識別子はフィルタ内で一意である必要がある。

このメソッドが成功すると、返される IPin インターフェイスに未処理の参照カウントが残る。使い終わった場合は、インターフェイスを必ず解放すること。

参照