PFND3DDDI_OPENADAPTER callback function

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

Syntax

PFND3DDDI_OPENADAPTER Pfnd3dddiOpenadapter;

HRESULT Pfnd3dddiOpenadapter(
  D3DDDIARG_OPENADAPTER *Arg1
)
{...}

Parameters

Arg1

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 code Description
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

   
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See Also

CreateDevice

D3DDDIARG_OPENADAPTER

pfnQueryAdapterInfoCb