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