Expand Minimize

DXGKARG_COMMITVIDPN structure

The DXGKARG_COMMITVIDPN structure holds arguments for the DxgkDdiCommitVidPn function. The DxgkDdiCommitVidPn function makes a specified video present network (VidPN) active on a display adapter.

Syntax


typedef struct _DXGKARG_COMMITVIDPN {
  D3DKMDT_HVIDPN                      hFunctionalVidPn;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID      AffectedVidPnSourceId;
  D3DKMDT_MONITOR_CONNECTIVITY_CHECKS MonitorConnectivityChecks;
  HANDLE                              hPrimaryAllocation;
  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 does not have 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 does not 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.

Flags

[in] 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

Version

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

Header

D3dkmddi.h (include D3dkmddi.h)

See also

DxgkDdiCommitVidPn
D3DKMDT_MONITOR_CONNECTIVITY_CHECKS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft