D3DKMDT_VPPR_GET_OFFSET_ROTATION函数 (d3dkmdt.h)

一个帮助程序函数,用于从 D3DKMDT_VIDPN_PRESENT_PATH_ROTATION 枚举的给定值中提取偏移角度。 只有支持独立于路径的轮换的驱动程序(DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION)才应调用此函数。

语法

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION D3DKMDT_VPPR_GET_OFFSET_ROTATION(
  D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Rotation
);

参数

Rotation

在输入时,来自 D3DKMDT_VIDPN_PRESENT_PATH_ROTATION 枚举的值。

在输出中,一个介于 1 和 4 之间的值,该值对应于 D3DKMDT_VIDPN_PRESENT_PATH_ROTATION 常量值的 OFFSET 部分。 输出值为 1(标识)表示偏移量 0 度,2 表示 90 度,依此表示。 输出值为 0 表示未初始化 VidPN 路径。

输出值始终是 D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT 结构中为此路径指定的受支持值之一。

返回值

返回的值对应于偏移角度,如下所示:

输入枚举值 输入枚举常量 以度为单位的偏移量 输出旋转值
0 D3DKMDT_VPPR_UNINITIALIZED - 0
1 D3DKMDT_VPPR_IDENTITY 0 1
2 D3DKMDT_VPPR_ROTATE90 0 1
3 D3DKMDT_VPPR_ROTATE180 0 1
4 D3DKMDT_VPPR_ROTATE270 0 1
5 D3DKMDT_VPPR_IDENTITY_OFFSET90 90 2
6 D3DKMDT_VPPR_ROTATE90_OFFSET90 90 2
7 D3DKMDT_VPPR_ROTATE180_OFFSET90 90 2
8 D3DKMDT_VPPR_ROTATE270_OFFSET90 90 2
9 D3DKMDT_VPPR_IDENTITY_OFFSET180 180 3
10 D3DKMDT_VPPR_ROTATE90_OFFSET180 180 3
11 D3DKMDT_VPPR_ROTATE180_OFFSET180 180 3
12 D3DKMDT_VPPR_ROTATE270_OFFSET180 180 3
13 D3DKMDT_VPPR_IDENTITY_OFFSET270 270 4
14 D3DKMDT_VPPR_ROTATE90_OFFSET270 270 4
15 D3DKMDT_VPPR_ROTATE180_OFFSET270 270 4
16 D3DKMDT_VPPR_ROTATE270_OFFSET270 270 4

言论

此函数在 D3dkmdt.h 中以内联的形式声明为:

__inline
D3DKMDT_VIDPN_PRESENT_PATH_ROTATION 
    D3DKMDT_VPPR_GET_OFFSET_ROTATION(
        D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Rotation)
{
    if ((Rotation >= D3DKMDT_VPPR_IDENTITY) &&
        (Rotation <= D3DKMDT_VPPR_ROTATE270_OFFSET270))
    {
        Rotation = (D3DKMDT_VIDPN_PRESENT_PATH_ROTATION)(
            ((Rotation - 1) / 4) + 1);
    }
    return Rotation;
}

当桌面窗口管理器(DWM)已轮换主克隆路径内容时,驱动程序应使用 Rotation 参数的输出值来旋转辅助克隆路径内容。 有关详细信息,请参阅 支持 Path-Independent 轮换

要求

要求 价值
最低支持的客户端 Windows 8.1,DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION
支持的最低服务器 Windows Server 2012 R2
目标平台 桌面
标头 d3dkmdt.h

另请参阅

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT