DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH callback function

The DxgkDdiUpdateActiveVidPnPresentPath function updates one of the video present paths that is currently active on the display adapter.

Syntax

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

Parameters

hAdapter

A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pUpdateActiveVidPnPresentPath

Return Value

DxgkDdiUpdateActiveVidPnPresentPathreturns one of the following values:

Remarks

The operating system calls the DxgkDdiUpdateActiveVidPnPresentPath function to control the settings of video present paths, such as path rotation, a presented content's geometry transformations, gamma ramps that are used to adjust the presented content's brightness, and so on.

Note The display miniport driver's DxgkDdiUpdateActiveVidPnPresentPath function must support gamma ramps.
Beginning with Windows 8, if the display miniport driver sets the SupportSmoothRotation member of the DXGK_DRIVERCAPS structure, it must support updating the path rotation on the adapter using the DxgkDdiUpdateActiveVidPnPresentPath function. The driver must always be able to set the path rotation during a call to the DxgkDdiCommitVidPn function.

The DxgkDdiUpdateActiveVidPnPresentPath function should be made pageable.

Requirements

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

See Also

D3DKMDT_VIDPN_PRESENT_PATH

DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH

DXGK_DRIVERCAPS

DxgkDdiAddDevice

DxgkDdiCommitVidPn