IWICBitmapEncoder_CreateNewFrame

新しい IWICBitmapFrameEncode インスタンスを生成する。

IWICBitmapEncoder_CreateNewFrame this, ppIFrameEncode, ppIEncoderOptions

this : [comobj] IWICBitmapEncoder インターフェースの COM オブジェクト変数
ppIFrameEncode : [comobj] 型: IWICBitmapFrameEncode** 新しい IWICBitmapFrameEncode インスタンスへのポインタを受け取るポインタ。
ppIEncoderOptions : [comobj] 型: IPropertyBag2** オプション。後続のフレーム初期化で使用する名前付きプロパティを受け取る。Remarks を参照。

(プラグイン / モジュール : com_misc.dll)

解説

新しい IWICBitmapFrameEncode インスタンスを生成する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

[備考]
ppIEncoderOptions パラメータは、エンコーダオプションを指定するために使用できる IPropertyBag2
を受け取るのに使える。これは ppIEncoderOptions に NULL の IPropertyBag2
ポインタへのポインタを渡すことで行う。返される IPropertyBag2
は、指定フォーマットで利用可能なすべてのエンコーダオプションが既定値で初期化されている。既定以外のエンコーディング動作を指定するには、必要なエンコーダオプションを
IPropertyBag2 に設定して IWICBitmapFrameEncode::Initialize に渡す。注: 初期化済みの
IPropertyBag2 へのポインタを渡してはならない。ポインタは上書きされ、元の IPropertyBag2 は解放されない。
エンコーダオプションを指定しないのであれば、ppIEncoderOptions に NULL
を渡してもよい。エンコーダオプションの設定例は Encoding Overview
を参照。複数フレームのエンコードをサポートするフォーマット (例えば TIFF、JPEG-XR) では、一度に 1
フレームしか扱えない。つまり CreateNewFrame を再度呼ぶ前に IWICBitmapFrameEncode::Commit
を呼ぶ必要がある。

情報