D3DKMDT_VIDPN_PRESENT_PATH_ROTATION enumeration (d3dkmdt.h)
The D3DKMDT_VIDPN_PRESENT_PATH_ROTATION enumeration is used to indicate the rotation angle applied to content displayed on a VidPN present path.
Syntax
typedef enum _D3DKMDT_VIDPN_PRESENT_PATH_ROTATION {
D3DKMDT_VPPR_UNINITIALIZED,
D3DKMDT_VPPR_IDENTITY,
D3DKMDT_VPPR_ROTATE90,
D3DKMDT_VPPR_ROTATE180,
D3DKMDT_VPPR_ROTATE270,
D3DKMDT_VPPR_IDENTITY_OFFSET90,
D3DKMDT_VPPR_ROTATE90_OFFSET90,
D3DKMDT_VPPR_ROTATE180_OFFSET90,
D3DKMDT_VPPR_ROTATE270_OFFSET90,
D3DKMDT_VPPR_IDENTITY_OFFSET180,
D3DKMDT_VPPR_ROTATE90_OFFSET180,
D3DKMDT_VPPR_ROTATE180_OFFSET180,
D3DKMDT_VPPR_ROTATE270_OFFSET180,
D3DKMDT_VPPR_IDENTITY_OFFSET270,
D3DKMDT_VPPR_ROTATE90_OFFSET270,
D3DKMDT_VPPR_ROTATE180_OFFSET270,
D3DKMDT_VPPR_ROTATE270_OFFSET270,
D3DKMDT_VPPR_UNPINNED,
D3DKMDT_VPPR_NOTSPECIFIED
} D3DKMDT_VIDPN_PRESENT_PATH_ROTATION;
Constants
D3DKMDT_VPPR_UNINITIALIZEDIndicates that a variable of type D3DKMDT_VIDPN_PRESENT_PATH_ROTATION has not yet been assigned a meaningful value. |
D3DKMDT_VPPR_IDENTITYIndicates that there is no rotation. |
D3DKMDT_VPPR_ROTATE90Indicates that the rotation angle is 90 degrees counter-clockwise. |
D3DKMDT_VPPR_ROTATE180Indicates that the rotation angle is 180 degrees counter-clockwise. |
D3DKMDT_VPPR_ROTATE270Indicates that the rotation angle is 270 degrees counter-clockwise. |
D3DKMDT_VPPR_IDENTITY_OFFSET90Indicates that source content is not modified in any way, and the display miniport driver should rotate this content an extra 90 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE90_OFFSET90Indicates that source content is rotated 90 degrees counter-clockwise, and the driver should rotate this content an extra 90 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE180_OFFSET90Indicates that source content is rotated 180 degrees counter-clockwise, and the driver should rotate this content an extra 90 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE270_OFFSET90Indicates that source content is rotated 270 degrees counter-clockwise, and the driver should rotate this content an extra 90 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_IDENTITY_OFFSET180Indicates that source content is not modified in any way, and the driver should rotate this content an extra 180 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE90_OFFSET180Indicates that source content is rotated 90 degrees counter-clockwise, and the driver should rotate this content an extra 180 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE180_OFFSET180Indicates that source content is rotated 180 degrees counter-clockwise, and the driver should rotate this content an extra 180 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE270_OFFSET180Indicates that source content is rotated 270 degrees, and the driver should rotate this content an extra 180 degrees. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_IDENTITY_OFFSET270Indicates that source content is not modified in any way, and the driver should rotate this content an extra 270 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE90_OFFSET270Indicates that source content is rotated 90 degrees counter-clockwise, and the driver should rotate this content an extra 270 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE180_OFFSET270Indicates that source content is rotated 180 degrees counter-clockwise, and the driver should rotate this content an extra 270 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_ROTATE270_OFFSET270Indicates that source content is rotated 270 degrees counter-clockwise, and the driver should rotate this content an extra 270 degrees counter-clockwise. For more info, see Remarks. Supported starting with Windows 8.1 Update. |
D3DKMDT_VPPR_UNPINNEDIndicates that no rotation angle has been pinned for the VidPN present path. |
D3DKMDT_VPPR_NOTSPECIFIEDIndicates that no rotation angle (including identity) has been specified. |
Remarks
The Rotation member of the D3DKMDT_VIDPN_PRESENT_PATH_TRANSFORMATION structure is a value from the D3DKMDT_VIDPN_PRESENT_PATH_ROTATION enumeration.
Starting with Windows 8.1 Update, new constant values (D3DKMDT_VPPR_XXX_OFFSETXXX) are available to specify both the default orientation of a display device and an additional angle (offset) that the user has rotated the device.
Here are some examples of how to set the default orientation and offset:
- If the topology is specified as:
- a single monitor,
- a non-path-independent rotation clone, or
- a primary monitor for a path-independent rotation clone,
- D3DKMDT_VPPR_IDENTITY
- D3DKMDT_VPPR_ROTATE90
- D3DKMDT_VPPR_ROTATE180
- D3DKMDT_VPPR_ROTATE270
- For a path-independent rotation clone, the secondary monitor probably has D3DKMDT_VPPR_XXX_OFFSET270 set if it is a portrait-first panel.
- Also consider these uncommon scenarios:
- For a path-independent rotation clone, a landscape-first display panel connected to a portrait-first primary device will probably have D3DKMDT_VPPR_XXX_OFFSET90 set.
- For a path-independent rotation clone on a system prior to Windows 8.1, a landscape-first display panel connected to a landscape-first primary device will probably have D3DKMDT_VPPR_XXX_OFFSET180 set.
Note The operating system does not update the value of the interface version value DXGKDDI_INTERFACE_VERSION to DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION. If you want to use the path-independent members in this structure, you should be sure that the interface version in your driver is >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION (0x4003).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | d3dkmdt.h |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for