Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IQualityControl

IQualityControl

COM
📘 Microsoft Learn (日本語) · English
IID56a868a5-0ad4-11ce-b03a-0020af0ba770継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IQualityControl インターフェイスは、品質制御 (Quality Control) のサポートを提供します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Notify(IBaseFilter* pSelf, Quality q)

Notify メソッドは、品質の変更が要求されたことをフィルターに通知します。

pSelfIBaseFilter*in品質通知を送信しているフィルターへのポインター。
qQualityinQuality 構造体。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

vtbl 4 HRESULT SetSink(IQualityControl* piqc)

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

piqcIQualityControl*in通知の送信先となる IQualityControl オブジェクトへのポインター。

戻り値

実装に依存する HRESULT 値を返します。HRESULT は、次の標準定数のいずれか、または一覧にないその他の値になることがあります。

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

解説(Remarks)

このメソッドの呼び出しを受け取るフィルターは、piqc を記録する必要がありますが、参照カウントを追加してはなりません。指定されるオブジェクトは品質マネージャーであり、フィルター グラフの一部 (たとえばプラグイン ディストリビューター) となります。これに参照カウントを追加すると、循環参照の問題を引き起こす可能性があります。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IQualityControl "{56A868A5-0AD4-11CE-B03A-0020AF0BA770}"
#usecom global IQualityControl IID_IQualityControl "{}"
#comfunc global IQualityControl_Notify   3 sptr,int
#comfunc global IQualityControl_SetSink  4 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。