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

IMFMediaEngineSrcElements

COM
📘 Microsoft Learn (日本語) · English
IID7a5e5354-b114-4c72-b991-3131d75032ea継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Media Engine にメディアリソースのリストを提供します。

解説(Remarks)

IMFMediaEngineSrcElements インターフェイスは、メディアリソースの順序付きリストを表します。

このインターフェイスを使用すると、アプリケーションは H.264 や Windows Media Video など、複数の異なるエンコード形式で同一のオーディオ/ビデオコンテンツを提供できます。特定のコーデックがユーザーのコンピューターに存在しない場合、Media Engine はリスト内の次の URL を試行します。このインターフェイスを使用するには、次の手順を実行します。

  1. このインターフェイスの実装を作成します。
  2. 実装を URL のリストで初期化します。必要に応じて、各 URL に MIME タイプとメディアクエリ文字列を指定します。
  3. IMFMediaEngine::SetSourceElements メソッドを呼び出します。

メソッド 6

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

vtbl 3 DWORD GetLength()

リスト内のソース要素の数を取得します。

戻り値

ソース要素の数を返します。

vtbl 4 HRESULT GetURL(DWORD index, LPWSTR* pURL)

リスト内の要素の URL を取得します。

indexDWORDinソース要素の 0 から始まるインデックス。ソース要素の数を取得するには、IMFMediaEngineSrcElements::GetLength を呼び出します。
pURLLPWSTR*outソース要素の URL を格納する BSTR を受け取ります。呼び出し元は、SysFreeString を呼び出して BSTR を解放する必要があります。URL が設定されていない場合、このパラメーターは NULL を受け取ります。

戻り値

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

vtbl 5 HRESULT GetType(DWORD index, LPWSTR* pType)

リスト内の要素の MIME タイプを取得します。

indexDWORDinソース要素の 0 から始まるインデックス。ソース要素の数を取得するには、IMFMediaEngineSrcElements::GetLength を呼び出します。
pTypeLPWSTR*outMIME タイプを格納する BSTR を受け取ります。呼び出し元は、SysFreeString を呼び出して BSTR を解放する必要があります。MIME タイプが設定されていない場合、このパラメーターは NULL を受け取ります。

戻り値

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

vtbl 6 HRESULT GetMedia(DWORD index, LPWSTR* pMedia)

リスト内の要素の対象メディアタイプを取得します。

indexDWORDinソース要素の 0 から始まるインデックス。ソース要素の数を取得するには、IMFMediaEngineSrcElements::GetLength を呼び出します。
pMediaLPWSTR*outメディアクエリ文字列を格納する BSTR を受け取ります。呼び出し元は、SysFreeString を呼び出して BSTR を解放する必要があります。メディアタイプが設定されていない場合、このパラメーターは NULL を受け取ります。

戻り値

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

解説(Remarks)

pMedia で返される文字列は、W3C の Media Queries 仕様に準拠したメディアクエリ文字列である必要があります。

vtbl 7 HRESULT AddElement(LPWSTR pURL, LPWSTR pType, LPWSTR pMedia)

リストの末尾にソース要素を追加します。

pURLLPWSTRinoptionalソース要素の URL、または NULL。
pTypeLPWSTRinoptionalソース要素の MIME タイプ、または NULL。
pMediaLPWSTRinoptional対象のメディアタイプを指定するメディアクエリ文字列、または NULL。指定する場合、文字列は W3C の Media Queries 仕様に準拠している必要があります。

戻り値

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

解説(Remarks)

このメソッドのパラメーターはいずれも NULL にできます。

このメソッドは、渡された BSTR のコピーを割り当てます。

vtbl 8 HRESULT RemoveAllElements()

リストからすべてのソース要素を削除します。

戻り値

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFMediaEngineSrcElements "{7A5E5354-B114-4C72-B991-3131D75032EA}"
#usecom global IMFMediaEngineSrcElements IID_IMFMediaEngineSrcElements "{}"
#comfunc global IMFMediaEngineSrcElements_GetLength          3
#comfunc global IMFMediaEngineSrcElements_GetURL             4 int,var
#comfunc global IMFMediaEngineSrcElements_GetType            5 int,var
#comfunc global IMFMediaEngineSrcElements_GetMedia           6 int,var
#comfunc global IMFMediaEngineSrcElements_AddElement         7 wstr,wstr,wstr
#comfunc global IMFMediaEngineSrcElements_RemoveAllElements  8
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。