Compartilhar via

Método ID2D1Factory::CreateHwndRenderTarget(constD2D1_RENDER_TARGET_PROPERTIES&,constD2D1_HWND_RENDER_TARGET_PROPERTIES&,ID2D1HwndRenderTarget**) (d2d1.h)

  • Artigo

Cria um ID2D1HwndRenderTarget, um destino de renderização que é renderizado em uma janela.

Quando você cria um destino de renderização e a aceleração de hardware está disponível, você aloca recursos na GPU do computador. Ao criar um destino de renderização uma vez e mantê-lo o maior tempo possível, você obtém benefícios de desempenho. Seu aplicativo deve criar destinos de renderização uma vez e mantê-los durante a vida útil do aplicativo ou até que o erro D2DERR_RECREATE_TARGET seja recebido. Ao receber esse erro, você precisa recriar o destino de renderização (e todos os recursos que ele criou).

Sintaxe

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 &

O modo de renderização, o formato de pixel, as opções de comunicação remota, as informações de DPI e o suporte mínimo do DirectX necessário para a renderização de hardware. Para obter informações sobre formatos de pixel com suporte, consulte Formatos de pixel com suporte e modos alfa.

hwndRenderTargetProperties

Tipo: [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES &

O identificador de janela, o tamanho inicial (em pixels) e as opções presentes.

hwndRenderTarget

Tipo: [out] ID2D1HwndRenderTarget**

Quando esse método retorna, contém o endereço do ponteiro para o objeto ID2D1HwndRenderTarget criado por esse método.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Quando você cria um destino de renderização e a aceleração de hardware está disponível, você aloca recursos na GPU do computador. Ao criar um destino de renderização uma vez e mantê-lo o maior tempo possível, você obtém benefícios de desempenho. Seu aplicativo deve criar destinos de renderização uma vez e mantê-los durante a vida útil do aplicativo ou até que o erro D2DERR_RECREATE_TARGET seja recebido. Ao receber esse erro, você precisa recriar o destino de renderização (e todos os recursos que ele criou).

Exemplos

O exemplo a seguir cria um 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 Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1Factory