DXGKARG_COMMITVIDPN structure (d3dkmddi.h)

The DXGKARG_COMMITVIDPN structure holds arguments for the DxgkDdiCommitVidPn function.

Syntax

typedef struct _DXGKARG_COMMITVIDPN {
       IN D3DKMDT_HVIDPN                      hFunctionalVidPn;
       IN D3DDDI_VIDEO_PRESENT_SOURCE_ID      AffectedVidPnSourceId;
       IN D3DKMDT_MONITOR_CONNECTIVITY_CHECKS MonitorConnectivityChecks;
       IN HANDLE                              hPrimaryAllocation;
  [in] IN DXGKARG_COMMITVIDPN_FLAGS           Flags;
} DXGKARG_COMMITVIDPN;

Members

hFunctionalVidPn

A handle to a functional VidPN object that is to be made active on the display adapter.

AffectedVidPnSourceId

The constant D3DDDI_ID_ALL or the identifier of a particular video present source in the VidPN:

• If this member is a source identifier, DxgkDdiCommitVidPn updates only the modes of the video present paths that originate at that source. DxgkDdiCommitVidPn doesn't need to inspect paths that originate from other sources because those paths are the same in the new VidPN as they are in the currently active VidPN.
• If this member is equal to D3DDDI_ID_ALL, DxgkDdiCommitVidPn must inspect and update the entire VidPN as a single transaction; that is, the entire new VidPN must be made active or the entire current VidPN must remain active.

MonitorConnectivityChecks

A D3DKMDT_MONITOR_CONNECTIVITY_CHECKS enumerator (D3DKMDT_MCC_IGNORE or D3DKMDT_MCC_ENFORCE) that specifies whether to verify that video outputs in the new topology have monitors connected:

• If this member is equal to D3DKMDT_MCC_ENFORCE and one of the video outputs in the new VidPN's topology doesn't have a monitor connected, DxgkDdiCommitVidPn must leave the currently active VidPN in place and return STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY.
• If this member is equal to D3DKMDT_MCC_IGNORE, DxgkDdiCommitVidPn can make the new VidPN active without checking to see whether any video outputs have monitors connected.

hPrimaryAllocation

A handle to the primary allocation associated with the video present source identified by AffectedVidPnSourceId.

[in] Flags

A DXGKARG_COMMITVIDPN_FLAGS structure that identifies details about a call to the DxgkDdiCommitVidPn function.

Remarks

The D3DDDI_ID_ALL constant is defined in D3dukmddi.h.

Requirements

See also

D3DKMDT_MONITOR_CONNECTIVITY_CHECKS

DxgkDdiCommitVidPn