Função D2D1CreateDeviceContext (d2d1_1.h)
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 |