DXGKCB_QUERYMONITORINTERFACE callback function (d3dkmddi.h)

Article
02/22/2024

DXGKCB_QUERYMONITORINTERFACE obtains a pointer to a DXGK_MONITOR_INTERFACE structure, which contains pointers to functions that the display miniport driver can call to obtain other interfaces that provide access to monitor descriptors, modes, and frequency ranges.

Syntax

DXGKCB_QUERYMONITORINTERFACE DxgkcbQuerymonitorinterface;

NTSTATUS DxgkcbQuerymonitorinterface(
  [in]  IN_CONST_HANDLE hAdapter,
  [in]  IN_CONST_DXGK_MONITOR_INTERFACE_VERSION MonitorInterfaceVersion,
  [out] DEREF_OUT_CONST_PPDXGK_MONITOR_INTERFACE ppMonitorInterface
)
{...}

Parameters

[in] hAdapter

A handle that represents a display adapter. The VidPN manager provided this handle to the display miniport driver in a call to DxgkDdiRecommendFunctionalVidPn, DxgkDdiIsSupportedVidPn, DxgkDdiEnumVidPnCofuncModality, or DxgkDdiCommitVidPn.

[in] MonitorInterfaceVersion

A value from the DXGK_MONITOR_INTERFACE_VERSION enumeration that specifies the version of the monitor interface being requested.

[out] ppMonitorInterface

A pointer to a pointer to the DXGK_MONITOR_INTERFACE structure.

Return value

DXGKCB_QUERYMONITORINTERFACE returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbQueryMonitorInterface via the DXGKRNL_INTERFACE.

Requirements

Requirement	Value
Minimum supported client	Windows Vista (WDDM 1.0)
Target Platform	Desktop
Header	d3dkmddi.h (include Dispmprt.h)
IRQL	<= APC_LEVEL