_D3DKMDT_VIDPN_PRESENT_PATH_SCALING Enumeration

The D3DKMDT_VIDPN_PRESENT_PATH_SCALING enumeration is used to indicate the scaling transformation applied to content displayed on a VidPN present path.

Syntax

typedef enum _D3DKMDT_VIDPN_PRESENT_PATH_SCALING { 
  D3DKMDT_VPPS_UNINITIALIZED           = 0,
  D3DKMDT_VPPS_IDENTITY                = 1,
  D3DKMDT_VPPS_CENTERED                = 2,
  D3DKMDT_VPPS_STRETCHED               = 3,
  D3DKMDT_VPPS_ASPECTRATIOCENTEREDMAX  = 4,
  D3DKMDT_VPPS_CUSTOM                  = 5,
  D3DKMDT_VPPS_RESERVED1               = 253,
  D3DKMDT_VPPS_UNPINNED                = 254,
  D3DKMDT_VPPS_NOTSPECIFIED            = 255
} D3DKMDT_VIDPN_PRESENT_PATH_SCALING;

Constants

D3DKMDT_VPPS_ASPECTRATIOCENTEREDMAX Indicates that the source content is scaled to fit the path's target while preserving the aspect ratio of the source. This constant value is available beginning with Windows 7. See further information in the Remarks section.
D3DKMDT_VPPS_CENTERED Indicates the centering transformation; the source content is presented unscaled, centered with respect to the spatial resolution of the target mode.
D3DKMDT_VPPS_CUSTOM Indicates that the path is capable of displaying one or more scaling modes that are not described by other constants of this enumeration. This constant value is available beginning with Windows 7. See further information in the Remarks section.
D3DKMDT_VPPS_IDENTITY Indicates the identity transformation; the source content is presented with no change. Note that this transformation is available only if the path's source mode has the same spatial resolution as the path's target mode.
D3DKMDT_VPPS_NOTSPECIFIED Indicates that no transformation has been specified. See further information in the Remarks section.
D3DKMDT_VPPS_RESERVED1 Reserved for system use. Do not use this value. This value will never be passed to a driver. This constant value is available beginning with Windows 7.
D3DKMDT_VPPS_STRETCHED Indicates that the source content is scaled to fit the path's target, and the aspect ratio of the source is not preserved.
D3DKMDT_VPPS_UNINITIALIZED Indicates that a variable of type D3DKMDT_VIDPN_PRESENT_PATH_SCALING has not yet been assigned a meaningful value.
D3DKMDT_VPPS_UNPINNED Indicates that no scaling transformation has been pinned for the VidPN present source.

Remarks

The Scaling member of the D3DKMDT_VIDPN_PRESENT_PATH_TRANSFORMATION structure is a value from the D3DKMDT_VIDPN_PRESENT_PATH_SCALING enumeration.

If D3DKMDT_VPPS_ASPECTRATIOCENTEREDMAX or D3DKMDT_VPPS_CUSTOM values are specified but the path is on a display miniport driver that does not support these values (which are available beginning with Windows 7), the driver's calls to DxgkDdiCommitVidPn should return STATUS_GRAPHICS_VIDPN_MODALITY_NOT_SUPPORTED, and the operating system will apply the system default scaling. If a driver cannot support the requested scaling value on the specified path, its calls to DxgkDdiCommitVidPn should return STATUS_GRAPHICS_VIDPN_MODALITY_NOT_SUPPORTED.

Requirements

   
Windows Driver kit version
Minimum KMDF version
Minimum UMDF version
Header d3dkmdt.h (include D3dkmdt.h)

See Also

DxgkDdiCommitVidPn
D3DKMDT_VIDPN_PRESENT_PATH_SCALING_SUPPORT

Send comments about this topic to Microsoft