função D3DKMDT_VPPR_GET_OFFSET_ROTATION (d3dkmdt.h)

Uma função auxiliar que extrai o ângulo de deslocamento de um determinado valor da enumeração D3DKMDT_VIDPN_PRESENT_PATH_ROTATION . Somente os drivers que dão suporte à rotação independente de caminho (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION) devem chamar essa função.

Sintaxe

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION D3DKMDT_VPPR_GET_OFFSET_ROTATION(
  D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Rotation
);

Parâmetros

Rotation

Na entrada, um valor da enumeração D3DKMDT_VIDPN_PRESENT_PATH_ROTATION .

Na saída, um valor entre 1 e 4, inclusive, que corresponde à parte OFFSET dos valores constantes D3DKMDT_VIDPN_PRESENT_PATH_ROTATION . Um valor de saída de 1 (identidade) representa 0 graus de deslocamento, 2 representa 90 graus e assim por diante. Um valor de saída de 0 indica que o caminho VidPN não foi inicializado.

O valor de saída é sempre um dos valores com suporte especificados para esse caminho na estrutura D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT .

Retornar valor

O valor retornado corresponde ao ângulo de deslocamento da seguinte maneira:

Valor de enumeração de entrada	Constante de enumeração de entrada	Deslocamento em graus	Valor de Rotação de Saída
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

Comentários

Essa função é declarada embutida em 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;
}

O driver deve usar o valor de saída do parâmetro Rotation para girar o conteúdo do caminho de clone secundário quando o DWM (Gerenciador de Janelas da Área de Trabalho) já tiver girado o conteúdo do caminho de clone primário. Para obter mais informações, consulte Suporte à rotação de Path-Independent.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1,DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION
Servidor mínimo com suporte	Windows Server 2012 R2
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmdt.h

Confira também

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT