Edit

DXGKDDI_RECOMMENDMONITORMODES callback function (d3dkmddi.h)

  • Article

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

See also

Monitor Source Mode Set Interface