Compartir a través de


Función D2D1CreateDeviceContext (d2d1_1.h)

Crea un nuevo contexto de dispositivo Direct2D asociado a una superficie DXGI.

Syntax

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

Parámetros

[in] dxgiSurface

La superficie DXGI con la que está asociado el contexto del dispositivo Direct2D.

[in, optional] creationProperties

Propiedades que se van a aplicar al contexto del dispositivo Direct2D.

[out] d2dDeviceContext

Cuando se devuelve esta función, contiene la dirección de un puntero a un contexto de dispositivo Direct2D.

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

HRESULT Description
S_OK No se produjo ningún error.
E_OUTOFMEMORY Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_INVALIDARG Se pasó un valor no válido al método .

Observaciones

Esta función también creará un id2D1Factory1 que se puede recuperar a través de ID2D1Resource::GetFactory.

Esta función también creará un nuevo id2D1Device que se puede recuperar a través de ID2D1DeviceContext::GetDevice.

El dispositivo DXGI se especificará implícitamente a través de dxgiSurface.

Si no se especifica creationProperties , el dispositivo Direct2D heredará su modo de subproceso del dispositivo DXGI implícito en dxgiSurface y el seguimiento de depuración no se habilitará.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 8 y Platform Update para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header d2d1_1.h
Library d2d1.lib
DLL de D2d1.dll

Consulte también

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory