ID2D1Factory_CreateDxgiSurfaceRenderTarget

DXGI (DirectX Graphics Infrastructure) サーフェイスに描画するレンダーターゲットを作成する。(overload 1/2)

ID2D1Factory_CreateDxgiSurfaceRenderTarget this, dxgiSurface, renderTargetProperties, renderTarget

this : [comobj] ID2D1Factory インターフェースの COM オブジェクト変数
dxgiSurface : [comobj] 型: IDXGISurface* レンダーターゲットが描画する IDXGISurface。
renderTargetProperties : [var] 型: const D2D1_RENDER_TARGET_PROPERTIES & レンダリングモード、ピクセル形式、リモート化オプション、DPI 情報、およびハードウェアレンダリングに必要な DirectX の最低サポート。対応ピクセル形式については「Supported Pixel Formats and Alpha Modes」を参照。
renderTarget : [comobj] 型: ID2D1RenderTarget** このメソッドが戻ると、このメソッドが作成した ID2D1RenderTarget オブジェクトへのポインターのアドレスが格納される。

(プラグイン / モジュール : com_misc.dll)

解説

DXGI (DirectX Graphics Infrastructure)
サーフェイスに描画するレンダーターゲットを作成する。(overload 1/2)

[戻り値]
型: HRESULT このメソッドが成功した場合 S_OK を返す。そうでなければ
[**HRESULT**](/windows/desktop/com/structure-of-com-error-codes)
エラーコードを返す。

[備考]
Direct3D サーフェイスに書き込むには、IDXGISurface を取得して
CreateDxgiSurfaceRenderTarget メソッドに渡して DXGI
サーフェイスレンダーターゲットを作成し、それを使って DXGI サーフェイスへ 2D コンテンツを描画できる。DXGI
サーフェイスレンダーターゲットは ID2D1RenderTarget の一種であり、他の Direct2D
レンダーターゲットと同様にリソースの作成や描画コマンドの発行に使用できる。DXGI サーフェイスレンダーターゲットと DXGI
サーフェイスは同じ DXGI 形式を使用しなければならない。レンダーターゲット作成時に DXGI_FORMAT_UNKOWN
を指定すると自動的にサーフェイスの形式が使用される。DXGI サーフェイスレンダーターゲットは DXGI
サーフェイス同期を行わない。DXGI サーフェイスレンダーターゲットの作成と使用の詳細は Direct2D and Direct3D
Interoperability Overview を参照。Direct2D と連携するには、IDXGISurface を提供する
Direct3D デバイスを D3D10_CREATE_DEVICE_BGRA_SUPPORT
フラグ付きで作成する必要がある。レンダーターゲット作成時にハードウェアアクセラレーションが利用可能な場合、コンピューターの GPU
上にリソースが確保される。レンダーターゲットを一度だけ作成してできるだけ長く保持することで性能上の利点が得られる。アプリケーションはレンダーターゲットを一度だけ作成し、アプリケーションの寿命の間、またはレンダーターゲットの
EndDraw メソッドが D2DERR_RECREATE_TARGET
エラーを返すまで保持すべきである。このエラーを受け取った場合は、レンダーターゲット（およびそれが作成したリソース）を作成し直す必要がある。

情報