DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET callback function

The pfnGetAdditionalMonitorModeSet function, available in the DXGK_MONITOR_INTERFACE_V2 interface beginning with Windows 7, returns a handle to an additional monitor source mode set object that is associated with a specified monitor.

Syntax


DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET pfnGetAdditionalMonitorModeSet;

NTSTATUS APIENTRY pfnGetAdditionalMonitorModeSet(
  _In_  const D3DKMDT_ADAPTER                hAdapter,
  _In_  const D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  _Out_       UINT                           *pNumberModes,
  _Out_       DXGK_TARGETMODE_DETAIL_TIMING  **ppAdditionalModesSet
)
{ ... }

Parameters

hAdapter [in]

[in] 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.

VideoPresentTargetId [in]

[in] An integer that identifies one of the video present targets on the display adapter. The returned ppAdditionalModesSet additional modes set object describes the additional monitor source mode sets that are available on the monitor that is connected to this video present target.

pNumberModes [out]

[out] A pointer to a variable that contains the number of additional timing modes of the video present target specified by VideoPresentTargetId.

ppAdditionalModesSet [out]

[out] A pointer to a variable that receives a pointer to a DXGK_TARGETMODE_DETAIL_TIMING structure. The structure describes a video present target's additional timing modes that are compatible with the display device.

Return value

The pfnAcquireMonitorSourceModeSet function returns one of the following values.

Return codeDescription
STATUS_SUCCESS

The function succeeded.

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.

STATUS_NOT_FOUND

The video present target identified by VideoPresentTargetId could not be found.

 

Remarks

VidPN target identifiers are assigned by the display miniport driver. The DxgkDdiQueryChildRelations function, implemented by the display miniport driver, returns an array of DXGK_CHILD_DESCRIPTOR structures, each of which contains an identifier.

This function is available beginning with Windows 7.

Requirements

Target platform

Desktop

Version

Available in Windows 7 and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGK_CHILD_DESCRIPTOR
DXGK_MONITOR_INTERFACE_V2
DXGK_TARGETMODE_DETAIL_TIMING
DxgkDdiStartDevice
DxgkDdiQueryChildRelations
DXGK_MONITOR_INTERFACE_V2::pfnReleaseAdditionalMonitorModeSet

 

 

Send comments about this topic to Microsoft

Show: