ID2D1Factory::CreateHwndRenderTarget(constD2D1_RENDER_TARGET_PROPERTIES&,constD2D1_HWND_RENDER_TARGET_PROPERTIES&,ID2D1HwndRenderTarget**) メソッド (d2d1.h)

  • [アーティクル]

ウィンドウにレンダリングするレンダー ターゲットである ID2D1HwndRenderTarget を作成します。

レンダー ターゲットを作成し、ハードウェア アクセラレーションを使用できる場合は、コンピューターの GPU にリソースを割り当てます。 レンダー ターゲットを 1 回作成し、可能な限り長く保持することで、パフォーマンス上の利点が得られます。 アプリケーションでは、一度レンダー ターゲットを作成し、アプリケーションの有効期間中、または D2DERR_RECREATE_TARGET エラーが発生するまでそれらを保持する必要があります。 このエラーが発生した場合は、レンダー ターゲット (および作成したリソース) を再作成する必要があります。

構文

HRESULT CreateHwndRenderTarget(
  const D2D1_RENDER_TARGET_PROPERTIES &      renderTargetProperties,
  const D2D1_HWND_RENDER_TARGET_PROPERTIES & hwndRenderTargetProperties,
  ID2D1HwndRenderTarget                      **hwndRenderTarget
);

パラメーター

renderTargetProperties

型: [in] const D2D1_RENDER_TARGET_PROPERTIES &

レンダリング モード、ピクセル形式、リモート処理オプション、DPI 情報、ハードウェア レンダリングに必要な最小 DirectX サポート。 サポートされているピクセル形式の詳細については、「 サポートされているピクセル形式とアルファ モード」を参照してください。

hwndRenderTargetProperties

型: [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES &

ウィンドウ ハンドル、初期サイズ (ピクセル単位)、および現在のオプション。

hwndRenderTarget

型: [out] ID2D1HwndRenderTarget**

このメソッドから制御が戻るときに、このメソッドによって作成された ID2D1HwndRenderTarget オブジェクトへのポインターのアドレスが格納されます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

レンダー ターゲットを作成し、ハードウェア アクセラレーションを使用できる場合は、コンピューターの GPU にリソースを割り当てます。 レンダー ターゲットを 1 回作成し、可能な限り長く保持することで、パフォーマンス上の利点が得られます。 アプリケーションでは、一度レンダー ターゲットを作成し、アプリケーションの有効期間中、または D2DERR_RECREATE_TARGET エラーが発生するまでそれらを保持する必要があります。 このエラーが発生した場合は、レンダー ターゲット (および作成したリソース) を再作成する必要があります。

例

次の例では、 ID2D1HwndRenderTarget を作成します。

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

要件

要件 値
サポートされている最小のクライアント Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1.h
Library D2d1.lib
[DLL] D2d1.dll

こちらもご覧ください

ID2D1Factory