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 サーフェス。

[in, optional] bitmapProperties

型: const D2D1_BITMAP_PROPERTIES1*

サーフェスに加えて指定されたビットマップ プロパティ。

[out] bitmap

種類: ID2D1Bitmap1**

このメソッドが戻るとき、 には、新しいビットマップ オブジェクトへのポインターのアドレスが格納されます。

戻り値

種類: HRESULT

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

注釈

ビットマップ プロパティが指定されていない場合は、次の情報が想定されます。

• ビットマップ DPI は 96 です。
• ピクセル形式は、サーフェスのピクセル形式と一致します。
• 返されるビットマップは、DXGI サーフェスのバインド フラグを継承します。
  • ただし、Direct2D に意味のあるフラグのサブセットのみが継承されます。 たとえば、D3D10_USAGE_DYNAMICはパブリック Direct2D フラグと互換性がありません。
• 色のコンテキストは不明です。
• ビットマップのアルファ モードは、事前乗算 (共通の場合) または直線 (A8) になります。

• ビットマップ DPI は、ビットマップ プロパティによって指定されます。
• dpiX と dpiY の両方が 0 の場合、ビットマップ DPI は 96 になります。
• ピクセル形式は、シェーダー リソース ビューまたはサーフェスのレンダー ターゲット ビューと互換性がある必要があります。
• ビットマップ オプションは、DXGI サーフェスのバインド フラグと互換性がある必要があります。 ただし、サブセットである可能性があります。 これは、ビットマップによって作成されるリソース ビューに影響します。
• カラー コンテキスト情報は、ビットマップ プロパティ (指定されている場合) から使用されます。

要件

こちらもご覧ください

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget