DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO callback function

The pfnAcquireNextModeInfo function returns a descriptor of the next mode in a specified VidPN source mode set, given the current mode.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
  DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}

Parameters

hVidPnSourceModeSet

[in] A handle to a VidPN source mode set object. The display miniport driver previously obtained this handle by calling the pfnAcquireSourceModeSet function of the DXGK_VIDPN_INTERFACE interface.

pVidPnSourceModeInfo

[in] A pointer to a D3DKMDT_VIDPN_SOURCE_MODE structure that describes the current mode. The display miniport driver previously obtained this pointer by calling pfnAcquireFirstModeInfo or pfnAcquireNextModeInfo.

ppNextVidPnSourceModeInfo

[out] A pointer to a variable that receives a pointer to a D3DKMDT_VIDPN_SOURCE_MODE structure that describes the next mode.

Return Value

The pfnAcquireNextModeInfo function returns one of the following values:

Return code Description
STATUS_SUCCESS
The function succeeded.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET
The handle supplied in hVidPnSourceModeSet was invalid.

Remarks

When you have finished using the D3DKMDT_VIDPN_SOURCE_MODE structure, you must release the structure by calling pfnReleaseModeInfo.

You can enumerate all the modes that belong to a VidPN source mode set object by calling pfnAcquireFirstModeInfo and then making a sequence of calls to pfnAcquireNextModeInfo.

The D3DKMDT_HVIDPNSOURCEMODESET data type is defined in D3dkmdt.h.

Requirements

   
Windows version Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

See Also

D3DKMDT_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo