DXGKDDI_QUERYADAPTERINFO callback function (d3dkmddi.h)
Dxgkrnl calls the display miniport driver's (KMD's) DxgkDdiQueryAdapterInfo function to retrieve configuration information from the graphics adapter.
Syntax
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
Parameters
[in] hAdapter
A handle to a context block that is associated with a display adapter. The KMD previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
[in] pQueryAdapterInfo
A pointer to a DXGKARG_QUERYADAPTERINFO structure that the KMD fills with the configuration information for the graphics adapter.
Return value
DxgkDdiQueryAdapterInfo returns STATUS_SUCCESS when it successfully retrieves the configuration information. Otherwise, it returns an NTSTATUS code such as one of the following values:
| Return code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | One or more passed parameter contained errors that prevented it from completing. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo couldn't allocate memory that was required for it to complete. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | The KMD isn't compatible with the user-mode display driver (UMD) that initiated the call to DxgkDdiQueryAdapterInfo (that is, supplied private data for a query to the KMD). |
Remarks
When the UMD calls the Direct3D runtime's pfnQueryAdapterInfoCb callback, a call to the DxgkDdiQueryAdapterInfo function is initiated.
If Dxgkrnl specifies DXGKQAITYPE_UMDRIVERPRIVATE in DXGKARG_QUERYADAPTERINFO::Type, pOutputData points to a proprietary structure that KMD fills with the configuration information that is necessary for the UMD to identify the adapter.
If Dxgkrnl specifies DXGKQAITYPE_DRIVERCAPS in DXGKARG_QUERYADAPTERINFO::Type, the KMD should populate the provided DXGK_DRIVERCAPS structure with information that the subsystem can use.
If Dxgkrnl specifies DXGKQAITYPE_QUERYSEGMENT in DXGKARG_QUERYADAPTERINFO::Type, the KMD should provide information about the memory segments that it supports. For more information about memory segments, see Initializing Use of Memory Segments.
DxgkDdiQueryAdapterInfo should be made pageable.
All drivers that support WDDM 2.6 and greater must implement the DxgkDdiQueryAdapterInfo callback.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista (WDDM 1.0) |
| Target Platform | Desktop |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |