Expand Minimize

DxgkDdiCommitVidPn routine

The DxgkDdiCommitVidPn function makes a specified video present network (VidPN) active on a display adapter.

Syntax


PDXGKDDI_COMMITVIDPN DxgkDdiCommitVidPn;

NTSTATUS APIENTRY DxgkDdiCommitVidPn(
  _In_  const HANDLE hAdapter,
  _In_  const DXGKARG_COMMITVIDPN CONST *pCommitVidPnArg
)
{ ... }

Parameters

hAdapter [in]

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

pCommitVidPnArg [in]

A pointer to a DXGKARG_COMMITVIDPN structure that contains function arguments.

Return value

DxgkDdiCommitVidPn returns one of the values in the following list. The VidPN referred to in the list is the VidPN represented by pCommitVidPnArg->hFunctionalVidPn.

STATUS_SUCCESS

The driver successfully handled the function call.

STATUS_GRAPHICS_GAMMA_RAMP_NOT_SUPPORTED

The display adapter does not support all of the path gamma ramps in the VidPN.

STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY

The topology of the VidPN is invalid. In particular, DxgkDdiCommitVidPn must return this value if pCommitVidPnArg->MonitorConnectivityChecks is equal to D3DKMDT_MCC_ENFORCE and one of the video outputs in the new VidPN's topology does not have a monitor connected.

STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED

One of the present paths in the topology does not support the specified content transformation.

STATUS_GRAPHICS_VIDPN_MODALITY_NOT_SUPPORTED

The display adapter does not currently support the set of modes that are pinned in the VidPN.

STATUS_NO_MEMORY

The driver could not complete this request because of insufficient memory.

Remarks

For more information about how the display miniport driver should handle calls to DxgkDdiCommitVidPn, see DXGKARG_COMMITVIDPN.

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.

Requirements

Version

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

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGK_DRIVERCAPS
DXGKARG_COMMITVIDPN
DxgkDdiAddDevice
DxgkDdiUpdateActiveVidPnPresentPath

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft