// d3d12umddi.h
PFND3D12DDI_OPENADAPTER Pfnd3d12ddiOpenadapter;
HRESULT Pfnd3d12ddiOpenadapter(
D3D12DDIARG_OPENADAPTER *unnamedParam1
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The PFND3D12DDI_OPENADAPTER function creates a graphics adapter object that is referenced in subsequent calls.
unnamedParam1A 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.
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. |
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.