D3DKMTEnumAdapters2 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmthk.h
NTSTATUS D3DKMTEnumAdapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);
View the official Windows Driver Kit DDI referenceNo description available.
The D3DKMTEnumAdapters2 function supplies information for enumerating all graphics and display adapters on the system.
unnamedParam1[in, out] Pointer to a D3DKMT_ENUMADAPTERS2 structure in which to supply information about adapters on the system. See Remarks.
D3DKMTEnumAdapters2 returns STATUS_SUCCESS upon success or an error such as one of the following.
| Return Code | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | The provided array is too small to receive all the adapters. |
| STATUS_INVALID_PARAMETER | pAdapters is NULL or is otherwise an invalid memory region. |
| STATUS_NO_MEMORY | Memory cannot be allocated to satisfy the operation. |
On input, NumAdapters specifies how many adapters can be returned in the empty array that pAdapters points to. On return, if D3DKMT_ENUMADAPTERS2 returns STATUS_SUCCESS:
If D3DKMT_ENUMADAPTERS2 returns an error, NumAdapters is undefined.
D3DKMTEnumAdapters2 is typically called twice:
For the first call, set pAdapters to NULL. D3DKMTEnumAdapters2 will write the maximum supported adapter count in NumAdapters.
For the second call, set NumAdapters to the value returned in the first call and set pAdapters to point to an array of NumAdapters D3DKMT_ENUMADAPTERS2 structures. D3DKMTEnumAdapters2 will fill in the array and pass back the number of array structures (adapters) that it filled.
Once the caller of D3DKMTEnumAdapters2 has successfully received an enumeration of the adapters, it is the caller's responsibility to manage the lifespan of the adapter D3DKMT_HANDLEs. These handles are returned through pAdapters, and they must be closed with D3DKMTCloseAdapter.