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 |