D3DKMDT_VPPR_GET_OFFSET_ROTATION Funktion (d3dkmdt.h)

Artikel
02/06/2025

Eine Hilfsfunktion, die den Offsetwinkel aus einem bestimmten Wert der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION-Enumeration extrahiert. Nur Treiber, die pfadunabhängige Drehung (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 eingaben, einem Wert aus der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION-Aufzählung.

Bei der Ausgabe entspricht ein Wert zwischen 1 und 4 einschließlich dem OFFSET- Teil der D3DKMDT_VIDPN_PRESENT_PATH_ROTATION Konstantenwerte. Ein Ausgabewert von 1 (Identität) stellt 0 Grad Offset dar, 2 steht für 90 Grad usw. Ein Ausgabewert von 0 gibt an, dass der VidPN-Pfad nicht initialisiert ist.

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

Rückgabewert

Der zurückgegebene Wert entspricht dem Offsetwinkel wie folgt:

Eingabeenumerationswert	Eingabeenumerationskonstante	Offset in Grad	Ausgabedrehungswert
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

Bemerkungen

Diese Funktion wird inline in D3dkmdt.h als:

__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 parameters Rotation verwenden, um den Inhalt des sekundären Klonpfads zu drehen, wenn der Desktop Window Manager (DWM) den primären Klonpfadinhalt bereits gedreht hat. Weitere Informationen finden Sie unter Unterstützen von Path-Independent Rotation.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1,DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_PATH_INDEPENDENT_ROTATION
mindestens unterstützte Server-	Windows Server 2012 R2
Zielplattform-	Desktop
Header-	d3dkmdt.h

Siehe auch

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION

D3DKMDT_VIDPN_PRESENT_PATH_ROTATION_SUPPORT

Freigeben über