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

IMFMediaSourceExtension

COM
📘 Microsoft Learn (日本語) · English
IIDe467b94e-a713-4562-a802-816a42e9008a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Media Source Extension (MSE) の機能を提供します。

解説(Remarks)

Media Source Extensions (MSE) は、HTML5 のメディア要素を拡張し、プラグインを使用せずにメディアストリームを動的に変更できるようにする World Wide Web Consortium (W3C) の標準です。IMFMediaSourceExtension インターフェイスおよび関連する Microsoft Win32 API は MSE を実装しており、MSE を実装する Web ブラウザーからのみ呼び出されることを想定しています。

MSE メディアソースは、ソースの ready 状態と、ソースにメディアデータを提供する IMFSourceBuffer オブジェクトのリストを管理します。

メソッド 10

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

vtbl 3 IMFSourceBufferList* GetSourceBuffers()

このメディアソースに関連付けられたソースバッファーのコレクションを取得します。

戻り値

ソースバッファーのコレクション。

vtbl 4 IMFSourceBufferList* GetActiveSourceBuffers()

メディアソースにメディアデータをアクティブに供給しているソースバッファーを取得します。

戻り値

アクティブなソースバッファーのリスト。

vtbl 5 MF_MSE_READY GetReadyState()

メディアソースの ready 状態を取得します。

戻り値

メディアソースの ready 状態。

vtbl 6 DOUBLE GetDuration()

メディアソースの継続時間を 100 ナノ秒単位で取得します。

戻り値

メディアソースの継続時間 (100 ナノ秒単位)。

vtbl 7 HRESULT SetDuration(DOUBLE duration)

メディアソースの継続時間を 100 ナノ秒単位で設定します。

durationDOUBLEinメディアソースの継続時間 (100 ナノ秒単位)。

戻り値

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

vtbl 8 HRESULT AddSourceBuffer(LPWSTR type, IMFSourceBufferNotify* pNotify, IMFSourceBuffer** ppSourceBuffer)

IMFMediaSourceExtension に関連付けられたバッファーのコレクションに IMFSourceBuffer を追加します。

typeLPWSTRin追加するソースバッファーのMIMEタイプ文字列。
pNotifyIMFSourceBufferNotify*inそのバッファーのイベント通知を受け取るIMFSourceBufferNotify。
ppSourceBufferIMFSourceBuffer**out生成されたIMFSourceBufferを受け取る出力ポインター。

戻り値

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

vtbl 9 HRESULT RemoveSourceBuffer(IMFSourceBuffer* pSourceBuffer)

IMFMediaSourceExtension オブジェクトが管理するソースバッファーのコレクションから、指定されたソースバッファーを削除します。

pSourceBufferIMFSourceBuffer*in削除するバッファー。

戻り値

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

vtbl 10 HRESULT SetEndOfStream(MF_MSE_ERROR error)

メディアストリームの終端に達したことを示します。

errorMF_MSE_ERRORinエラー情報を渡すために使用します。

戻り値

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

vtbl 11 BOOL IsTypeSupported(LPWSTR type)

指定した MIME タイプがメディアソースでサポートされているかどうかを示す値を取得します。

typeLPWSTRinサポートの有無を確認するメディアタイプ。

戻り値

メディアタイプがサポートされている場合は true、それ以外の場合は false。

vtbl 12 IMFSourceBuffer* GetSourceBuffer(DWORD dwStreamIndex)

バッファーのコレクション内で指定したインデックスにある IMFSourceBuffer を取得します。

dwStreamIndexDWORDinコレクション内のバッファーの位置。

戻り値

ソースバッファー。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFMediaSourceExtension "{E467B94E-A713-4562-A802-816A42E9008A}"
#usecom global IMFMediaSourceExtension IID_IMFMediaSourceExtension "{}"
#comfunc global IMFMediaSourceExtension_GetSourceBuffers        3
#comfunc global IMFMediaSourceExtension_GetActiveSourceBuffers  4
#comfunc global IMFMediaSourceExtension_GetReadyState           5
#comfunc global IMFMediaSourceExtension_GetDuration             6
#comfunc global IMFMediaSourceExtension_SetDuration             7 double
#comfunc global IMFMediaSourceExtension_AddSourceBuffer         8 wstr,sptr,sptr
#comfunc global IMFMediaSourceExtension_RemoveSourceBuffer      9 sptr
#comfunc global IMFMediaSourceExtension_SetEndOfStream          10 int
#comfunc global IMFMediaSourceExtension_IsTypeSupported         11 wstr
#comfunc global IMFMediaSourceExtension_GetSourceBuffer         12 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。