共用方式為

ID2D1Factory：：CreateHwndRenderTarget (constD2D1_RENDER_TARGET_PROPERTIES*，constD2D1_HWND_RENDER_TARGET_PROPERTIES*，ID2D1HwndRenderTarget**) 方法 (d2d1.h)

  • 發行項

建立 ID2D1HwndRenderTarget，這是轉譯至視窗的轉譯目標。

當您建立轉譯目標且硬體加速可用時，您會在計算機的 GPU 上配置資源。 藉由建立轉譯目標一次並盡可能保留，即可獲得效能優勢。 您的應用程式應該建立轉譯目標一次，並在應用程式存留期間或直到收到 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 支援。 如需支援圖元格式的資訊，請參閱 支援的圖元格式和 Alpha 模式。

hwndRenderTargetProperties

Type： [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES*

視窗句柄、初始大小 (以像素為單位) ，以及呈現選項。

hwndRenderTarget

類型： [out] ID2D1HwndRenderTarget**

當這個方法傳回時，會包含這個方法所建立 之ID2D1HwndRenderTarget 物件的指標位址。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當您建立轉譯目標和硬體加速可用時，您會在計算機的 GPU 上配置資源。 藉由建立轉譯目標一次並盡可能保留，即可獲得效能優勢。 您的應用程式應該建立轉譯目標一次，並在應用程式存留期間或直到收到 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
標頭 d2d1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1Factory