ID2D1Factory2::CreateDevice method

Creates an ID2D1Device1 object.

Syntax


HRESULT CreateDevice(
  [in]  IDXGIDevice  *dxgiDevice,
  [out] ID2D1Device1 **d2dDevice1
);

Parameters

dxgiDevice [in]

Type: IDXGIDevice*

The IDXGIDevice object used when creating the ID2D1Device1.

d2dDevice1 [out]

Type: ID2D1Device1**

The requested ID2D1Device1 object.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULTDescription
S_OKNo error occurred.
E_OUTOFMEMORYDirect2D could not allocate sufficient memory to complete the call.
E_INVALIDARGAn invalid parameter was passed to the returning function.
D3DERR_OUTOFVIDEOMEMORYDirect3D does not have enough display memory to perform the operation.

 

Remarks

The Direct2D device defines a resource domain in which a set of Direct2D objects and Direct2D device contexts can be used together. Each call to CreateDevice returns a unique ID2D1Device1 object, even if you pass the same IDXGIDevice multiple times.

Requirements

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2d1_2.h

Library

D2d1.lib

DLL

D2d1.dll

See also

ID2D1Factory2
ID2D1Factory1
ID2D1Device
ID2D1Device1
ID2D1DeviceContext
ID2D1DeviceContext::GetDevice

 

 

Show: