次の方法で共有

IPin::QueryInternalConnections

  • [アーティクル]

QueryInternalConnections メソッドは、(フィルタ内で) 内部的にこのピンに接続しているピンを取得する。

構文

  HRESULT QueryInternalConnections(
  IPin **apPin,
  ULONG *nPin
);

パラメータ

apPin

[out] IPin ポインタの配列のアドレス。

nPin

[in, out] 入力時は配列のサイズを指定する。メソッドが返ったとき、この値には配列内に返されるポインタの数が設定されている。

戻り値

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

値 説明
S_FALSE 配列のサイズが不適当。
S_OK 成功。
E_FAIL 失敗。
E_NOTIMPL 実装されていない。

注意

いくつかのフィルタでは、入力ピンは固有の出力ピンに対応している。各ピンで、このメソッドは対応するピンのポインタを配列に格納する。各入力ピンが各出力ピンにデータを提供する場合、ピンは E_NOTIMPL を返す。

メソッドが成功し、1 以上の *nPin 値を返すと、その配列には IPin インターフェイスへのポインタが格納されている。使い終わったら、各インターフェイス ポインタを必ず解放すること。