Edit

DXGKDDI_MONITORSOURCEMODESET_ADDMODE callback function (d3dkmddi.h)

  • Article

The pfnAddMode function adds a monitor source mode to a specified monitor source mode set object.

Syntax

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

Parameters

[in] hMonitorSourceModeSet

A handle to a monitor source mode set object. The display miniport driver previously obtained this handle by calling the pfnAcquireMonitorSourceModeSet function of the Monitor interface.

[in] pMonitorSourceModeInfo

A pointer to a D3DKMDT_MONITOR_SOURCE_MODE structure that describes the monitor source mode. The display miniport driver previously obtained this structure by calling pfnCreateNewModeInfo.

Return value

The pfnAddMode function returns one of the following values.

Return code Description
STATUS_SUCCESS The function succeeded.
STATUS_NO_MEMORY The function failed because it could not allocate enough memory.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE The information supplied in pMonitorSourceModeInfo was invalid.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET The handle supplied in hMonitorSourceModeSet was invalid.
STATUS_GRAPHICS_INVALID_FREQUENCY The frequency information supplied in pMonitorSourceModeInfo was invalid.
STATUS_GRAPHICS_INVALID_ACTIVE_REGION The active region supplied in pMonitorSourceModeInfo was invalid.
STATUS_GRAPHICS_INVALID_TOTAL_REGION The total region supplied in pMonitorSourceModeInfo was invalid.
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET The mode set already contains a mode that is identical to the mode supplied in pMonitorSourceModeInfo.
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE The identifier supplied in pMonitorSourceModeInfo->Id is already being used for another mode in the mode set.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED The structure pointed to by pMonitorSourceModeInfo was not created for addition to the mode set specified by hMonitorSourceModeSet.

Remarks

If pMonitorSourceModeInfo->Preference is equal to D3DKMDT_MP_PREFERRED, the newly added mode becomes the preferred mode of the mode set.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Desktop
Header d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

See also

pfnCreateNewModeInfo