PFND3D12DDI_OPENADAPTER callback function (d3d12umddi.h)

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

Syntax

PFND3D12DDI_OPENADAPTER Pfnd3d12ddiOpenadapter;

HRESULT Pfnd3d12ddiOpenadapter(
  D3D12DDIARG_OPENADAPTER *unnamedParam1
)
{...}

Parameters

unnamedParam1

A pointer to a D3D12DDIARG_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

PFND3D12DDI_OPENADAPTER returns one of the following values:

Return code	Description
S_OK	The graphics adapter object was successfully created.
E_OUTOFMEMORY	PFND3D12DDI_OPENADAPTER could not allocate memory that was required for it to complete.

Remarks

The graphics adapter object that is created by the PFND3D12DDI_OPENADAPTER function represents the underlying graphics hardware. Before the Direct3D runtime can create a display device by calling PFND3D12DDI_CREATEDEVICE_0003, 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

Requirement	Value
Target Platform	Windows
Header	d3d12umddi.h