DXGKDDI_MONITORSOURCEMODESET_CREATENEWMODEINFO callback function (d3dkmddi.h)

Artikel
02/22/2024

The pfnCreateNewModeInfo function returns a pointer to a D3DKMDT_MONITOR_SOURCE_MODE structure that the display miniport driver populates before calling pfnAddMode.

Syntax

DXGKDDI_MONITORSOURCEMODESET_CREATENEWMODEINFO DxgkddiMonitorsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_MONITOR_SOURCE_MODE ppNewMonitorSourceModeInfo
)
{...}

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.

[out] ppNewMonitorSourceModeInfo

A pointer to a variable that receives a pointer to a newly created D3DKMDT_MONITOR_SOURCE_MODE structure allocated by the VidPN manager.

Return value

The pfnCreateNewModeInfo function 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.

Remarks

After you call pfnCreateNewModeInfo to obtain a D3DKMDT_MONITOR SOURCE_MODE structure, you must do one, but not both, of the following:

Populate the structure and pass it to pfnAddMode.
Release the structure by calling pfnReleaseModeInfo.

Requirements

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

Delen via