IMFMediaEngineExtension

アプリケーションが Media Engine でメディアリソースを読み込めるようにします。

このインターフェイスを使用するには、IMFMediaEngineClassFactory::CreateInstance メソッドを呼び出す際に MF_MEDIA_ENGINE_EXTENSION 属性を設定します。

指定した種類のメディアリソースをこのオブジェクトが読み込めるかどうかを照会します。

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

Media Engine 拡張機能が 1 つ以上の MIME タイプをサポートする場合は、このメソッドを実装してください。

バイトストリームまたはメディアソースを作成する非同期要求を開始します。

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

このメソッドは、type パラメーターの値に応じて、バイトストリームまたはメディアソースの作成をオブジェクトに要求します。

• type が MF_OBJECT_BYTESTREAM の場合、このメソッドは bstrURL で指定された URL のバイトストリームを作成します。この場合、pByteStream パラメーターは NULL です。
• type が MF_OBJECT_MEDIASOURCE の場合、このメソッドは pByteStream パラメーターで指定されたバイトストリームを使用してメディアソースを作成します。この場合、pByteStream は NULL になることもあります。

このメソッドは非同期に実行されます。Media Engine は IMFMediaEngineExtension::EndCreateObject メソッドを呼び出して操作を完了します。

実装に関する注意

Media Engine 拡張機能は、カスタムのバイトストリームオブジェクト、カスタムのメディアソース、またはその両方をサポートするために使用できます。バイトストリームの場合は、type が MF_OBJECT_BYTESTREAM のときにバイトストリームオブジェクトを作成します。メディアソースの場合は、type が MF_OBJECT_MEDIASOURCE のときにソースを作成します。

URL を読み込むために、Media Engine は次の手順を実行します。

1. URL からバイトストリームの作成を試みます。
2. バイトストリームが正常に作成された場合、そのバイトストリームからメディアソースの作成を試みます。
3. バイトストリームを作成できない場合、URL から直接メディアソースの作成を試みます。

各手順で、Media Engine は拡張オブジェクトに対して IMFMediaEngineExtension::BeginCreateObject を呼び出します。BeginCreateObject メソッドが失敗すると、Media Engine は Source Resolver を試します。

BeginCreateObject メソッドでは、次のいずれのケースを処理するかを選択できます。

• type パラメーターが MF_OBJECT_BYTESTREAM の場合。URL からバイトストリームを作成します。
• type パラメーターが MF_OBJECT_MEDIASOURCE で、pByteStream がバイトストリームを指している場合。そのバイトストリームを使用してメディアソースを作成します。
• type パラメーターが MF_OBJECT_MEDIASOURCE で、pByteStream が NULL の場合。URL からメディアソースを作成します。

処理しないケースについては失敗コードを返してください。

例:

• カスタムのメディア形式をサポートするには、メディアソースを実装します。メディアソースが特別なバイトストリーム実装を必要としない場合は、type が MF_OBJECT_MEDIASOURCE で、pByteStream が非 NULL のときにメディアソースを作成します。この場合、標準の Microsoft Media Foundation バイトストリーム実装が使用されます。
• カスタムの URL スキームをサポートするには、type が MF_OBJECT_BYTESTREAM のケースを処理し、その URL を読み取れるバイトストリームオブジェクトを返します。

BeginCreateObject メソッドが成功した場合、操作は非同期に実行される必要があります。操作が完了したら、pCallback で指定されたコールバックインターフェイスの IMFAsyncCallback::Invoke メソッドを呼び出します。Media Engine は IMFMediaEngineExtension::EndCreateObject を呼び出して操作を完了します。

現在のオブジェクト作成要求をキャンセルします。

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

このメソッドは、以前の BeginCreateObject の呼び出しをキャンセルしようとします。ただし、このメソッドは非同期であるため、操作をキャンセルする前に完了してしまう場合があります。

バイトストリームまたはメディアソースを作成する非同期要求を完了します。

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

Media Engine は、IMFMediaEngineExtension::BeginCreateObject メソッドを完了するためにこのメソッドを呼び出します。

#define global IID_IMFMediaEngineExtension "{2F69D622-20B5-41E9-AFDF-89CED1DDA04E}"
#usecom global IMFMediaEngineExtension IID_IMFMediaEngineExtension "{}"
#comfunc global IMFMediaEngineExtension_CanPlayType           3 int,wstr,var
#comfunc global IMFMediaEngineExtension_BeginCreateObject     4 wstr,sptr,int,sptr,sptr,sptr
#comfunc global IMFMediaEngineExtension_CancelObjectCreation  5 sptr
#comfunc global IMFMediaEngineExtension_EndCreateObject       6 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。