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

NTSTATUS
APIENTRY
  DXGKDDI_COMMITVIDPN(
    CONST HANDLE  hAdapter,
    CONST DXGKARG_COMMITVIDPN* CONST  pCommitVidPnArg
    );

Parameters

hAdapter

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

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.

The driver should pass through any error code that it gets from the operating system for which it does not have a fallback code path. Such errors will be caught and evaluated by the DDI validation layer.

Comments

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

Requirements

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

IRQL: PASSIVE_LEVEL

Headers: Declared in D3dkmddi.h. Include D3dkmddi.h.

See Also

DXGKARG_COMMITVIDPN, DxgkDdiAddDevice

APIScan Requirements

Header: D3dkmddi.h
Function: DxgkDdiCommitVidPn