Compartilhar via

Função D2D1CreateDeviceContext (d2d1_1.h)

Cria um novo contexto de dispositivo Direct2D 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 contexto de dispositivo Direct2D.

Valor de retorno

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

HRESULT Description
S_OK Nenhum erro ocorreu.
E_OUTOFMEMORY O 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.

Observações

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 forem especificados , 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header d2d1_1.h
Library d2d1.lib
de DLL D2d1.dll

Consulte também

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory

  • Last updated on