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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

HRESULT 説明
S_OK エラーは発生していません。
E_OUTOFMEMORY Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。
E_INVALIDARG 無効なパラメーターが返される関数に渡されました。

注釈

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に設定すると、新しく作成されたビットマップで指定したアルファ モードが強制的に使用されます。

要件

要件 値
サポートされている最小のクライアント Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1_1.h
[DLL] D2d1.dll

こちらもご覧ください

ID2D1DeviceContext