D3DKMTOpenAdapterFromDeviceName function (d3dkmthk.h)
The D3DKMTOpenAdapterFromDeviceName function maps a device name to a graphics adapter handle and, if the adapter contains multiple monitor outputs, to one of those outputs.
Syntax
NTSTATUS D3DKMTOpenAdapterFromDeviceName(
[in, out] D3DKMT_OPENADAPTERFROMDEVICENAME *unnamedParam1
);
Parameters
[in, out] unnamedParam1
A pointer to a D3DKMT_OPENADAPTERFROMDEVICENAME structure that describes the parameters that are required to perform the mapping.
Return value
D3DKMTOpenAdapterFromDeviceName returns one of the following values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The mapping was performed successfully. |
| STATUS_INVALID_PARAMETER | Parameters were validated and determined to be incorrect or the Windows Vista display driver model was not used. |
This function might also return other NTSTATUS values.
Remarks
A graphics adapter corresponds to a video card. A monitor output corresponds to a head on a video card. A system with a single video card contains only one adapter. However, if the video card supports multiple heads, it supports outputting to multiple monitors.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Universal |
| Header | d3dkmthk.h (include D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |