Creates a new Direct2D device context associated with a DXGI surface.
HRESULT WINAPI D2D1CreateDeviceContext( _In_ IDXGISurface *dxgiSurface, _In_opt_ const D2D1_CREATION_PROPERTIES *creationProperties, _Out_ ID2D1DeviceContext **d2dDeviceContext );
- dxgiSurface [in]
The DXGI surface the Direct2D device context is associated with.
- creationProperties [in, optional]
The properties to apply to the Direct2D device context.
- d2dDeviceContext [out]
When this function returns, contains the address of a pointer to a Direct2D device context.
The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.
|S_OK||No error occurred.|
|E_OUTOFMEMORY||Direct2D could not allocate sufficient memory to complete the call.|
|E_INVALIDARG||An invalid value was passed to the method.|
The DXGI device will be specified implicitly through dxgiSurface.
The created device context will have exactly the same behavior as if ID2D1DeviceContext::SetTargetSurface were called with the corresponding surface.
If creationProperties are not specified, the Direct2D device will inherit its threading mode from the DXGI device implied by dxgiSurface and debug tracing will not be enabled.
Minimum supported client
|Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]|
Minimum supported server
|Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]|
Minimum supported phone
|Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]|