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