DXGKDDI_RECOMMENDMONITORMODES callback function (d3dkmddi.h)
The DxgkDdiRecommendMonitorModes function inspects the monitor source mode set that is associated with a particular video present target and possibly adds modes to the set.
Syntax
DXGKDDI_RECOMMENDMONITORMODES DxgkddiRecommendmonitormodes;
NTSTATUS DxgkddiRecommendmonitormodes(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDMONITORMODES_CONST pRecommendMonitorModes
)
{...}
Parameters
[in] hAdapter
A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
[in] pRecommendMonitorModes
A pointer to a DXGKARG_RECOMMENDMONITORMODES structure that contains function arguments.
Return value
DxgkDdiRecommendMonitorModes returns one of the following values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The function succeeded. |
| STATUS_NO_MEMORY | The function failed because it was unable to allocate enough memory. |
The miniport driver should pass through any error code that it gets from the operating system for which it does not have a fallback code path.
Remarks
DxgkDdiRecommendMonitorModes should be made pageable.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | < DISPATCH_LEVEL |