ID2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) メソッド (d2d1_1.h)
ターゲット サーフェスとして設定したり、追加のカラー コンテキスト情報を指定したりできる、DXGI サーフェスからビットマップを作成します。
構文
HRESULT CreateBitmapFromDxgiSurface(
[in] IDXGISurface *surface,
[in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
[out] ID2D1Bitmap1 **bitmap
);
パラメーター
[in] surface
種類: IDXGISurface*
ビットマップの作成元となる DXGI サーフェス。
メモ DXGI サーフェスは、Direct2D デバイス コンテキストが関連付けられているのと同じ Direct3D デバイスから作成されている必要があります。
[in, optional] bitmapProperties
型: const D2D1_BITMAP_PROPERTIES1*
サーフェスに加えて指定されたビットマップ プロパティ。
[out] bitmap
種類: ID2D1Bitmap1**
このメソッドが戻るとき、 には、新しいビットマップ オブジェクトへのポインターのアドレスが格納されます。
戻り値
種類: HRESULT
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生していません。 |
| E_OUTOFMEMORY | Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。 |
| E_INVALIDARG | 無効な値が メソッドに渡されました。 |
| D3DERR_OUTOFVIDEOMEMORY | Direct3D には、操作を実行するのに十分なディスプレイ メモリがありません。 |
注釈
ビットマップ プロパティが指定されていない場合は、次の情報が想定されます。
- ビットマップ DPI は 96 です。
- ピクセル形式は、サーフェスのピクセル形式と一致します。
- 返されるビットマップは、DXGI サーフェスのバインド フラグを継承します。
- ただし、Direct2D に意味のあるフラグのサブセットのみが継承されます。 たとえば、D3D10_USAGE_DYNAMICはパブリック Direct2D フラグと互換性がありません。
- 色のコンテキストは不明です。
- ビットマップのアルファ モードは、事前乗算 (共通の場合) または直線 (A8) になります。
- ビットマップ DPI は、ビットマップ プロパティによって指定されます。
- dpiX と dpiY の両方が 0 の場合、ビットマップ DPI は 96 になります。
- ピクセル形式は、シェーダー リソース ビューまたはサーフェスのレンダー ターゲット ビューと互換性がある必要があります。
- ビットマップ オプションは、DXGI サーフェスのバインド フラグと互換性がある必要があります。 ただし、サブセットである可能性があります。 これは、ビットマップによって作成されるリソース ビューに影響します。
- カラー コンテキスト情報は、ビットマップ プロパティ (指定されている場合) から使用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1_1.h |
| [DLL] | D2d1.dll |