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

IMFMediaSourceEx

COM
📘 Microsoft Learn (日本語) · English
IID3c9b2eb9-86d5-4514-a394-f56664f9f0d8継承元IMFMediaSource自前メソッド開始 vtbl13

公式ドキュメント

IMFMediaSource インターフェイスを拡張し、メディアソースに追加の機能を提供します。

解説(Remarks)

このインターフェイスの実装は、メディアソースで必要とされないメソッドについては E_NOTIMPL を返すことができます。

メソッド 3

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

vtbl 13 HRESULT GetSourceAttributes(IMFAttributes** ppAttributes)

メディアソースの属性ストアを取得します。

ppAttributesIMFAttributes**outIMFAttributes インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値

このメソッドは次のいずれかの値を返します。

戻りコード 説明
S_OK
 成功しました。
E_NOTIMPL
 メディアソースがソースレベルの属性をサポートしていません。

解説(Remarks)

IMFAttributes ポインターを使用して、ソース全体に適用される属性を取得または設定します。ストリームレベルの属性については、代わりに IMFMediaSourceEx::GetStreamAttributes メソッドを使用してください。

vtbl 14 HRESULT GetStreamAttributes(DWORD dwStreamIdentifier, IMFAttributes** ppAttributes)

メディアソース上のストリームの属性ストアを取得します。

dwStreamIdentifierDWORDinストリームの識別子。識別子を取得するには、ストリーム記述子に対して IMFStreamDescriptor::GetStreamIdentifier を呼び出します。
ppAttributesIMFAttributes**outIMFAttributes インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値

このメソッドは次のいずれかの値を返します。

戻りコード 説明
S_OK
 成功しました。
E_NOTIMPL
 メディアソースがストリームレベルの属性をサポートしていません。
MF_E_INVALIDSTREAMNUMBER
 ストリーム識別子が無効です。

解説(Remarks)

IMFAttributes ポインターを使用して、指定したストリームに適用される属性を取得または設定します。ソース全体に適用される属性については、代わりに IMFMediaSourceEx::GetSourceAttributes メソッドを使用してください。

vtbl 15 HRESULT SetD3DManager(IUnknown* pManager)

メディアソースに Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager へのポインターを設定します。

pManagerIUnknown*inDXGI Manager の IUnknown インターフェイスへのポインター。メディアソースは、このポインターに対して IMFDXGIDeviceManager インターフェイスをクエリする必要があります。

戻り値

このメソッドは次のいずれかの値を返します。

戻りコード 説明
S_OK
 成功しました。
E_NOTIMPL
 メディアソースがソースレベルの属性をサポートしていません。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFMediaSourceEx "{3C9B2EB9-86D5-4514-A394-F56664F9F0D8}"
#usecom global IMFMediaSourceEx IID_IMFMediaSourceEx "{}"
#comfunc global IMFMediaSourceEx_GetSourceAttributes  13 sptr
#comfunc global IMFMediaSourceEx_GetStreamAttributes  14 int,sptr
#comfunc global IMFMediaSourceEx_SetD3DManager        15 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。