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

こちらもご覧ください

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget