IMFMediaEngineClassFactory
COM公式ドキュメント
Media Engine のインスタンスを作成します。
解説(Remarks)
このインターフェイスを使用する前に、CoInitializeEx と MFStartup を呼び出してください。
このインターフェイスへのポインターを取得するには、CoCreateInstance を呼び出します。クラス識別子は CLSID_MFMediaEngineClassFactory です。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Media Engine の新しいインスタンスを作成します。
| dwFlags | DWORD | in | MF_MEDIA_ENGINE_CREATEFLAGS 列挙体のフラグを 0 個以上ビット単位の OR で結合した値です。 |
| pAttr | IMFAttributes* | in | 属性ストアの IMFAttributes インターフェイスへのポインターです。 このパラメーターは Media Engine の構成属性を指定します。属性ストアを作成するには MFCreateAttributes を呼び出します。その後、Media Engine Attributes の一覧から 1 つ以上の属性を設定します。詳細については「解説」を参照してください。 |
| ppPlayer | IMFMediaEngine** | out | IMFMediaEngine インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。 |
戻り値
このメソッドは次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 必須の属性が pAttr に含まれていないか、無効な属性の組み合わせが使用されました。 |
解説(Remarks)
このメソッドを呼び出す前に、MFStartup を呼び出してください。
Media Engine は 3 つの異なるモードをサポートします。
| Mode | Description |
|---|---|
| フレームサーバーモード |
このモードでは、Media Engine は非圧縮のビデオフレームをアプリケーションに配信します。各フレームの表示は、Microsoft Direct3D やその他のレンダリング手法を用いてアプリケーションが担当します。
オーディオのレンダリングは Media Engine が行い、アプリケーションはオーディオのレンダリングを担当しません。 フレームサーバーモードが既定のモードです。 |
| レンダリングモード |
このモードでは、Media Engine はオーディオとビデオの両方をレンダリングします。ビデオは、アプリケーションが提供するウィンドウまたは Microsoft DirectComposition ビジュアルにレンダリングされます。
レンダリングモードを有効にするには、MF_MEDIA_ENGINE_PLAYBACK_HWND 属性または MF_MEDIA_ENGINE_PLAYBACK_VISUAL 属性のいずれかを設定します。 |
| オーディオモード |
このモードでは、Media Engine はビデオを伴わずオーディオのみをレンダリングします。
オーディオモードを有効にするには、dwFlags パラメーターに MF_MEDIA_ENGINE_AUDIOONLY フラグを設定します。 |
初期化属性
pAttr パラメーターには次の属性が定義されています。目的とするモードに応じて、必須のものと省略可能なものがあります。| Feature | Attributes | Frame Server Mode | Rendering Mode | Audio Mode |
|---|---|---|---|---|
| イベントコールバック | MF_MEDIA_ENGINE_CALLBACK | 必須。 | 必須。 | 必須。 |
| レンダーターゲット | 次のいずれか: これらの属性は相互に排他的です。いずれかの属性を設定すると、Media Engine はレンダリングモードになります。 | 設定しない。 | 必須。 | 設定しない。 |
| Direct3D 形式 | MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT | 必須。 | 省略可能。 | 設定しない。 |
| Microsoft DirectX Graphics Infrastructure (DXGI) デバイスマネージャー | MF_MEDIA_ENGINE_DXGI_MANAGER | 省略可能。 | 省略可能。 | 設定しない。 |
| Media Engine 拡張 | MF_MEDIA_ENGINE_EXTENSION | 省略可能。 | 省略可能。 | 省略可能。 |
| コンテンツ保護 | 次のいずれか: | 省略可能。 | 省略可能。 | 省略可能。 |
| オーディオ再生 | 次のいずれか: | 省略可能。 | 省略可能。 | 省略可能。 |
Windows Phone 8
この API はサポートされています。電話では、Media Engine はフレームサーバーモードのみをサポートします。レンダリングモードまたはオーディオモードでインターフェイスを初期化しようとすると失敗します。
時間範囲オブジェクトを作成します。
| ppTimeRange | IMFMediaTimeRange** | out | IMFMediaTimeRange インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
メディアエラーオブジェクトを作成します。
| ppError | IMFMediaError** | out | IMFMediaError インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMFMediaEngineClassFactory "{4D645ACE-26AA-4688-9BE1-DF3516990B93}"
#usecom global IMFMediaEngineClassFactory IID_IMFMediaEngineClassFactory "{}"
#comfunc global IMFMediaEngineClassFactory_CreateInstance 3 int,sptr,sptr
#comfunc global IMFMediaEngineClassFactory_CreateTimeRange 4 sptr
#comfunc global IMFMediaEngineClassFactory_CreateError 5 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。