D3DKMDT_VPPR_GET_OFFSET_ROTATION-Funktion (d3dkmdt.h)

Artikel
02/26/2024

Eine Hilfsfunktion, die den Offsetwinkel aus einem bestimmten Wert der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION-Enumeration extrahiert. Nur Treiber, die eine pfadunabhängige Rotation (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION) unterstützen, sollten diese Funktion aufrufen.

Syntax

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION D3DKMDT_VPPR_GET_OFFSET_ROTATION(
  D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Rotation
);

Parameter

Rotation

Bei der Eingabe ein Wert aus der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Enumeration.

In der Ausgabe ein Wert zwischen 1 und 4, einschließlich, der dem OFFSET-Teil des D3DKMDT_VIDPN_PRESENT_PATH_ROTATION konstanten Werten entspricht. Ein Ausgabewert von 1 (Identität) stellt 0 Grad offset, 2 90 Grad usw. dar. Der Ausgabewert 0 gibt an, dass der VidPN-Pfad nicht initialisiert wird.

Der Ausgabewert ist immer einer der unterstützten Werte, die für diesen Pfad in der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT-Struktur angegeben werden.

Rückgabewert

Der zurückgegebene Wert entspricht dem Offsetwinkel wie folgt:

Eingabeaufzählungswert	Eingabeaufzählungskonstante	Offset in Grad	Ausgaberotationswert
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

Hinweise

Diese Funktion wird in "D3dkmdt.h" als inline deklariert:

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

Der Treiber sollte den Ausgabewert des Rotationsparameters verwenden, um den Inhalt des sekundären Klonpfads zu rotieren, wenn der Desktopfenster-Manager (DWM) den Inhalt des primären Klonpfads bereits gedreht hat. Weitere Informationen finden Sie unter Unterstützung Path-Independent Drehung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1,DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Desktop
Kopfzeile	d3dkmdt.h

Weitere Informationen

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT

Freigeben über