DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET callback function (d3dkmddi.h)
The pfnGetMonitorFrequencyRangeSet function returns a handle to the monitor frequency range set object that is associated with a specified monitor.
Syntax
DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;
NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}
Parameters
[in] hAdapter
A handle that identifies a display adapter. The Microsoft DirectX graphics kernel subsystem previously provided this handle to the display miniport driver in the DxgkInterface parameter of the DxgkDdiStartDevice function.
[in] VideoPresentTargetId
An integer that identifies one of the video present targets on the display adapter. The returned monitor frequency range set object describes the frequency ranges available on the monitor that is connected to this video present target.
[out] phMonitorFrequencyRangeSet
A pointer to a variable that receives a handle to the monitor frequency range set object.
[out] ppMonitorFrequencyRangeSetInterface
A pointer to a variable that receives a pointer to a DXGK_MONITORFREQUENCYRANGESET_INTERFACE structure. The structure contains pointers to functions that the display miniport driver can call to inspect and alter the monitor frequency range set object.
Return value
The pfnGetMonitorFrequencyRangeSet function returns one of the following values.
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The function succeeded. |
| STATUS_INVALID_PARAMETER | An invalid parameter was supplied. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | The handle supplied in hAdapter was invalid. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | The identifier supplied in VideoPresentTargetId was invalid. |
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | There is no monitor connected to the video present target identified by VideoPresentTargetId. |
This function might also return other error codes that are defined in Ntstatus.h.
Remarks
VidPN target identifiers are assigned by the display miniport driver. The DxgkDdiQueryChildRelationsfunction, implemented by the display miniport driver, returns an array of DXGK_CHILD_DESCRIPTOR structures, each of which contains an identifier.
You do not need to release the handle returned in phMonitorFrequencyRangeSet.
This function is also available in the DXGK_MONITOR_INTERFACE_V2 interface beginning with Windows 7.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |