ID2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) メソッド (d2d1_1.h)

WIC ビットマップをコピーして Direct2D ビットマップを作成します。

構文

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

パラメーター

[in] wicBitmapSource

型: IWICBitmapSource*

コピー元の WIC ビットマップ ソース。

[in, optional] bitmapProperties

型: const D2D1_BITMAP_PROPERTIES1*

ビットマップ作成オプションを指定するビットマップ プロパティ構造体。

[out] bitmap

型: ID2D1Bitmap1**

新しく作成されたビットマップ オブジェクトのアドレス。

戻り値

型: HRESULT

このメソッドは HRESULT を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。

注釈

Windows 8.1 以降では、 bitmapProperties パラメーターは省略可能です。 指定されていない場合、作成されたビットマップは wicBitmapSource からピクセル形式とアルファ モードを継承します。 サポートされているピクセル形式とアルファ モードの一覧については、「 サポートされているピクセル形式とアルファ モード」を参照してください。

bitmapProperties パラメーターを指定する場合、bitmapProperties->pixelFormat の値はDXGI_FORMAT_UNKNOWNであるか、wicBitmapSource の WIC ピクセル形式と一致する必要があります。

bitmapProperties->pixelFormat.alphaMode が D2D1_ALPHA_MODE_UNKNOWN に設定されている場合、新しく作成されたビットマップは wicBitmapSource からアルファ モードを継承します。 bitmapProperties->pixelFormat.alphaMode を D2D1_ALPHA_MODE_PREMULTIPLIED、D2D1_ALPHA_MODE_STRAIGHT、またはD2D1_ALPHA_MODE_IGNOREに設定すると、新しく作成されたビットマップで指定したアルファ モードが強制的に使用されます。

Requirements

こちらも参照ください

ID2D1DeviceContext