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 |