función D3DKMDT_VPPR_GET_OFFSET_ROTATION (d3dkmdt.h)

Función auxiliar que extrae el ángulo de desplazamiento de un valor determinado de la enumeración D3DKMDT_VIDPN_PRESENT_PATH_ROTATION. Solo los controladores que admiten la rotación independiente de la ruta de acceso (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION) deben llamar a esta función.

Sintaxis

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION D3DKMDT_VPPR_GET_OFFSET_ROTATION(
  D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Rotation
);

Parámetros

Rotation

En la entrada, un valor de la enumeración D3DKMDT_VIDPN_PRESENT_PATH_ROTATION.

En la salida, un valor comprendido entre 1 y 4, ambos incluidos, que corresponde a la parte de OFFSET de los valores constantes de D3DKMDT_VIDPN_PRESENT_PATH_ROTATION. Un valor de salida de 1 (identidad) representa 0 grados de desplazamiento, 2 representa 90 grados, etc. Un valor de salida de 0 indica que la ruta de acceso vidPN no se inicializa.

El valor de salida siempre es uno de los valores admitidos especificados para esta ruta de acceso en la estructura D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT.

Valor devuelto

El valor devuelto corresponde al ángulo de desplazamiento de la siguiente manera:

Valor de enumeración de entrada	Constante de enumeración de entrada	Desplazamiento en grados	Valor de rotación de salida
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

Observaciones

Esta función se declara en línea en D3dkmdt.h como:

__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;
}

El controlador debe usar el valor de salida del parámetro Rotation para rotar el contenido de la ruta de acceso de clonación secundaria cuando el Administrador de ventanas de escritorio (DWM) ya ha girado el contenido de la ruta de acceso de clonación principal. Para obtener más información, consulta compatibilidad con Path-Independent rotación.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8.1,DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION
servidor mínimo admitido	Windows Server 2012 R2
de la plataforma de destino de	Escritorio
encabezado de	d3dkmdt.h

Consulte también

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT