Blt
Expand Minimize

OpenAdapter routine

The OpenAdapter function creates a graphics adapter object that is referenced in subsequent calls.

Syntax


PFND3DDDI_OPENADAPTER OpenAdapter;

__checkReturn HRESULT APIENTRY OpenAdapter(
  _Inout_  D3DDDIARG_OPENADAPTER *pOpenData
)
{ ... }

Parameters

pOpenData [in, out]

A pointer to a D3DDDIARG_OPENADAPTER structure. On input, this structure contains information that the driver can use. On output, the driver specifies information that the Microsoft Direct3D runtime can use.

Return value

OpenAdapter returns one of the following values:

Return codeDescription
S_OK

The graphics adapter object is successfully created.

E_OUTOFMEMORY

OpenAdapter could not allocate the required memory for it to complete.

 

Remarks

The graphics adapter object that is created by OpenAdapter represents the underlying graphics hardware. Before the Microsoft Direct3D runtime can create a display device by calling CreateDevice, the user-mode display driver should call the pfnQueryAdapterInfoCb function to query for the graphics hardware capabilities from the display miniport driver.

The Direct3D runtime can open multiple graphics adapter objects from a single graphics adapter.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

CreateDevice
D3DDDIARG_OPENADAPTER
pfnQueryAdapterInfoCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.