次の方法で共有

IQualityControl::SetSink

  • [アーティクル]

SetSink メソッドは、品質メッセージを受け取る IQualityControl オブジェクトを設定する。

構文

  HRESULT SetSink(
  IQualityControl *piqc
);

パラメータ

piqc

通知の送信先の IQualityControl オブジェクトへのポインタ。

戻り値

実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。

戻りコード 説明
E_FAIL 失敗。
E_POINTER NULL ポインタ引数。
E_INVALIDARG 無効な引数。
E_NOTIMPL メソッドがサポートされていない。
S_OK または NOERROR 成功。

注意

このメソッドの呼び出しを受け取るフィルタは、piqc を記録しなければならないが、それに参照カウントを追加してはならない。ポインタが指すオブジェクトは、品質マネージャであり、フィルタ グラフ (たとえば、PID) の一部である。ここに参照カウントを追加すると、循環参照の危険性がある。

piqc で指定されたオブジェクトの参照は、このメソッドが値 NULL で呼び出されるまで有効であることが保証される。

参照