次の方法で共有


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