ID2D1Factory_CreateDCRenderTarget

Windows GDI デバイスコンテキストに描画するレンダーターゲットを作成する。

ID2D1Factory_CreateDCRenderTarget this, renderTargetProperties, dcRenderTarget

this : [comobj] ID2D1Factory インターフェースの COM オブジェクト変数
renderTargetProperties : [var] 型: const D2D1_RENDER_TARGET_PROPERTIES* レンダリングモード、ピクセル形式、リモート化オプション、DPI 情報、およびハードウェアレンダリングに必要な DirectX の最低サポート。デバイスコンテキスト (DC) レンダーターゲットが GDI と連携できるようにするには、DXGI 形式を DXGI_FORMAT_B8G8R8A8_UNORM に、アルファモードを D2D1_ALPHA_MODE_PREMULTIPLIED または D2D1_ALPHA_MODE_IGNORE に設定する。ピクセル形式の詳細については「Supported Pixel Formats and Alpha Modes」を参照。
dcRenderTarget : [comobj] 型: ID2D1DCRenderTarget** このメソッドが戻ると、dcRenderTarget にはメソッドが作成した ID2D1DCRenderTarget へのポインターのアドレスが格納される。

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

解説

Windows GDI デバイスコンテキストに描画するレンダーターゲットを作成する。

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

[備考]
DC レンダーターゲットでレンダリングする前に、レンダーターゲットの BindDC メソッドで GDI DC
と関連付けておく必要がある。これは DC が変わるたび、および描画先領域のサイズが変わるたびに行う。DC レンダーターゲットが GDI
と連携できるようにするには、レンダーターゲットの DXGI 形式を DXGI_FORMAT_B8G8R8A8_UNORM
に、アルファモードを D2D1_ALPHA_MODE_PREMULTIPLIED または D2D1_ALPHA_MODE_IGNORE
に設定する。アプリケーションはレンダーターゲットを一度だけ作成し、アプリケーションの寿命の間、またはレンダーターゲットの EndDraw
メソッドが D2DERR_RECREATE_TARGET
エラーを返すまで保持すべきである。このエラーを受け取った場合は、レンダーターゲット（およびそれが作成したリソース）を作成し直す必要がある。

情報