Compartir a través de


Función D2D1CreateDeviceContext (d2d1_1.h)

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

Sintaxis

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 esta función devuelve, contiene la dirección de un puntero a un contexto de dispositivo Direct2D.

Valor devuelto

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

HRESULT Descripción
S_OK No se ha producido 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 .

Comentarios

Esta función también creará un nuevo 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

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1_1.h
Archivo DLL D2d1.dll

Consulte también

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory