Função D2D1CreateDeviceContext (d2d1_1.h)

Artigo
02/28/2024

Cria uma nova Direct2D contexto de dispositivo associado a uma superfície DXGI.

Sintaxe

HRESULT D2D1CreateDeviceContext(
  [in]           IDXGISurface                   *dxgiSurface,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1DeviceContext             **d2dDeviceContext
);

Parâmetros

[in] dxgiSurface

A superfície DXGI à qual o contexto do dispositivo Direct2D está associado.

[in, optional] creationProperties

As propriedades a serem aplicadas ao contexto do dispositivo Direct2D.

[out] d2dDeviceContext

Quando essa função retorna, contém o endereço de um ponteiro para um Direct2D contexto de dispositivo.

Retornar valor

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT	Descrição
S_OK	Não ocorreu nenhum erro.
E_OUTOFMEMORY	Direct2D não pôde alocar memória suficiente para concluir a chamada.
E_INVALIDARG	Um valor inválido foi passado para o método .

Comentários

Essa função também criará uma nova ID2D1Factory1 que pode ser recuperada por meio de ID2D1Resource::GetFactory.

Essa função também criará um novo ID2D1Device que pode ser recuperado por meio de ID2D1DeviceContext::GetDevice.

O dispositivo DXGI será especificado implicitamente por meio de dxgiSurface.

Se creationProperties não for especificado, o dispositivo Direct2D herdará seu modo de threading do dispositivo DXGI implícito por dxgiSurface e o rastreamento de depuração não será habilitado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1_1.h
DLL	D2d1.dll