ID2D1Factory::CreateHwndRenderTarget(constD2D1_RENDER_TARGET_PROPERTIES*,constD2D1_HWND_RENDER_TARGET_PROPERTIES*,ID2D1HwndRenderTarget**) (d2d1.h)

  • Artículo

Crea un ID2D1HwndRenderTarget, un destino de representación que se representa en una ventana.

Cuando se crea un destino de representación y la aceleración de hardware está disponible, se asignan recursos en la GPU del equipo. Al crear un destino de representación una vez y conservarlo siempre que sea posible, obtendrá ventajas de rendimiento. La aplicación debe crear destinos de representación una vez y mantenerlos durante la vida útil de la aplicación o hasta que se reciba el error D2DERR_RECREATE_TARGET . Cuando reciba este error, debe volver a crear el destino de representación (y los recursos que creó).

Sintaxis

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

Parámetros

renderTargetProperties

Tipo: [in] const D2D1_RENDER_TARGET_PROPERTIES*

El modo de representación, el formato de píxeles, las opciones de comunicación remota, la información de PPP y la compatibilidad mínima con DirectX que se necesita para la representación de hardware. Para obtener información sobre los formatos de píxeles admitidos, vea Formatos de píxeles admitidos y Modos alfa.

hwndRenderTargetProperties

Tipo: [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES*

Identificador de ventana, tamaño inicial (en píxeles) y opciones presentes.

hwndRenderTarget

Tipo: [out] ID2D1HwndRenderTarget**

Cuando este método vuelve, contiene la dirección del puntero al objeto ID2D1HwndRenderTarget creado por este método.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Cuando se crea un destino de representación y la aceleración de hardware está disponible, se asignan recursos en la GPU del equipo. Al crear un destino de representación una vez y conservarlo siempre que sea posible, obtendrá ventajas de rendimiento. La aplicación debe crear destinos de representación una vez y mantenerlos durante la vida útil de la aplicación o hasta que se reciba el error D2DERR_RECREATE_TARGET . Cuando reciba este error, debe volver a crear el destino de representación (y los recursos que creó).

Ejemplos

En el ejemplo siguiente se crea un 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
    );

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d2d1.h
Library D2d1.lib
Archivo DLL D2d1.dll

Consulte también

ID2D1Factory