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

IMFSinkWriterEncoderConfig

COM
📘 Microsoft Learn (日本語) · English
IID17c3779e-3cde-4ede-8c60-3899f5f53ad6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

メディアタイプおよびエンコーダー構成を動的に変更するための追加機能を Sink Writer 上で提供します。

解説(Remarks)

Sink Writer は、Windows 8.1 でこのインターフェイスを実装します。このインターフェイスへのポインターを取得するには、IMFSinkWriter に対して QueryInterface を呼び出します。

メソッド 2

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

vtbl 3 HRESULT SetTargetMediaType(DWORD dwStreamIndex, IMFMediaType* pTargetMediaType, IMFAttributes* pEncodingParameters)

Sink Writer のエンコード先のターゲットメディアタイプを動的に変更します。

dwStreamIndexDWORDinストリームインデックスを指定します。
pTargetMediaTypeIMFMediaType*inエンコード先となる新しいメディア形式です。
pEncodingParametersIMFAttributes*inoptionalエンコーダーを構成するための新しいエンコードパラメーターのセットです。 指定しない場合は、以前に指定されたパラメーターが使用されます。

戻り値

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

解説(Remarks)

新しいメディアタイプは、使用しているメディアシンク、およびシステムにインストールされているエンコーダー MFT でサポートされている必要があります。

vtbl 4 HRESULT PlaceEncodingParameters(DWORD dwStreamIndex, IMFAttributes* pEncodingParameters)

新しいエンコーダー設定のコレクションでエンコーダー構成を動的に更新します。

dwStreamIndexDWORDinストリームインデックスを指定します。
pEncodingParametersIMFAttributes*inエンコーダーを構成するためのエンコードパラメーターのセットです。

戻り値

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

解説(Remarks)

エンコーダーは、以前にキューに入れられたすべての入力メディアサンプルが IMFTransform::ProcessInput を通じてエンコーダーに送信された後に、これらの設定で構成されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFSinkWriterEncoderConfig "{17C3779E-3CDE-4EDE-8C60-3899F5F53AD6}"
#usecom global IMFSinkWriterEncoderConfig IID_IMFSinkWriterEncoderConfig "{}"
#comfunc global IMFSinkWriterEncoderConfig_SetTargetMediaType       3 int,sptr,sptr
#comfunc global IMFSinkWriterEncoderConfig_PlaceEncodingParameters  4 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。