IMFQualityAdvise
COM公式ドキュメント
品質マネージャーがパイプライン内のコンポーネントの音声または映像の品質を調整できるようにします。
解説(Remarks)
品質マネージャーは通常、品質マネージャーの IMFQualityManager::NotifyTopology メソッドが呼び出されたときにこのインターフェイスを取得します。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ドロップモードを設定します。ドロップモードでは、コンポーネントはドロップモードのレベルに応じて、多かれ少なかれ積極的にサンプルをドロップします。
| eDropMode | MF_QUALITY_DROP_MODE | in | 要求するドロップモード。MF_QUALITY_DROP_MODE 列挙体のメンバーとして指定します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| コンポーネントは、指定されたモードまたはそれより上位のモードをサポートしていません。 |
解説(Remarks)
このメソッドをメディアソースに対して呼び出した場合、メディアソースはシン化(間引き)された出力と非シン化出力を切り替えることがあります。その場合、影響を受けるストリームは MEStreamThinMode イベントを送信して遷移を通知します。この操作は非同期です。SetDropMode が戻った後、遷移前にキューに入れられたサンプルを受け取ることがあります。MEStreamThinMode イベントは、ストリーム内で遷移が発生する正確なポイントを示します。
品質レベルを設定します。品質レベルは、コンポーネントがサンプルを消費または生成する方法を決定します。
| eQualityLevel | MF_QUALITY_LEVEL | in | 要求する品質レベル。MF_QUALITY_LEVEL 列挙体のメンバーとして指定します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| コンポーネントは、指定された品質レベルまたはそれより下位のレベルをサポートしていません。 |
現在のドロップモードを取得します。
| peDropMode | MF_QUALITY_DROP_MODE* | out | ドロップモードを受け取ります。MF_QUALITY_DROP_MODE 列挙体のメンバーとして指定されます。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 |
現在の品質レベルを取得します。
| peQualityLevel | MF_QUALITY_LEVEL* | out | 品質レベルを受け取ります。MF_QUALITY_LEVEL 列挙体のメンバーとして指定されます。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 |
指定した時間間隔にわたってサンプルをドロップします。
| hnsAmountToDrop | LONGLONG | in | ドロップする時間の長さ。100ナノ秒単位で指定します。この値は常に絶対値です。このメソッドを複数回呼び出す場合でも、前回の呼び出しの時間を加算しないでください。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| オブジェクトはこのメソッドをサポートしていません。 |
解説(Remarks)
理想的には、品質マネージャーはレンダラーが処理に遅れないようにできます。しかし遅れが実際に発生した場合、単に品質を下げるだけではレンダラーが追いつける保証はありません。その結果、音声と映像の同期がずれることがあります。この問題を解決するために、品質マネージャーは DropTime を呼び出して、指定した時間間隔にわたってレンダラーがサンプルを速やかにドロップするよう要求できます。その期間の後、レンダラーはサンプルのドロップを停止します。
このメソッドは主に映像レンダラーを対象としています。音声サンプルをドロップすると音声のグリッチが発生し、望ましくありません。
コンポーネントがこのメソッドをサポートしていない場合は、MF_E_DROPTIME_NOT_SUPPORTED を返す必要があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMFQualityAdvise "{EC15E2E9-E36B-4F7C-8758-77D452EF4CE7}" #usecom global IMFQualityAdvise IID_IMFQualityAdvise "{}" #comfunc global IMFQualityAdvise_SetDropMode 3 int #comfunc global IMFQualityAdvise_SetQualityLevel 4 int #comfunc global IMFQualityAdvise_GetDropMode 5 var #comfunc global IMFQualityAdvise_GetQualityLevel 6 var #comfunc global IMFQualityAdvise_DropTime 7 int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IMFQualityAdvise "{EC15E2E9-E36B-4F7C-8758-77D452EF4CE7}" #usecom global IMFQualityAdvise IID_IMFQualityAdvise "{}" #comfunc global IMFQualityAdvise_SetDropMode 3 int #comfunc global IMFQualityAdvise_SetQualityLevel 4 int #comfunc global IMFQualityAdvise_GetDropMode 5 sptr #comfunc global IMFQualityAdvise_GetQualityLevel 6 sptr #comfunc global IMFQualityAdvise_DropTime 7 int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。