IDXGISwapChain1::SetRotation-Methode (dxgi1_2.h)
Legt die Drehung der Backpuffer für die Swapchain fest.
Syntax
HRESULT SetRotation(
[in] DXGI_MODE_ROTATION Rotation
);
Parameter
[in] Rotation
Ein DXGI_MODE_ROTATION typisierter Wert, der angibt, wie die Drehung der Rückpuffer für die Swapchain festgelegt werden soll.
Rückgabewert
SetRotation gibt Folgendes zurück:
- S_OK, wenn die Drehung erfolgreich festgelegt wurde.
- DXGI_ERROR_INVALID_CALL, wenn es sich bei der Swapchain um ein Bitblockübertragungsmodell (Bitblt) handelt. Die Swapchain muss ein Flip-Modell sein, um SetRotation erfolgreich aufzurufen.
- Möglicherweise andere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.
Plattformupdate für Windows 7: Unter Windows 7 oder Windows Server 2008 R2 mit installiertem Plattformupdate für Windows 7 schlägt SetRotation mit DXGI_ERROR_INVALID_CALL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.
Hinweise
Sie können SetRotation nur verwenden, um die Rückpuffer für Flip-Model-Swapchains zu rotieren, die Sie im Fenstermodus präsentieren.
SetRotation wird nicht für das Rotieren der Rückpuffer für Flip-Model-Swapchains unterstützt, die Sie im Vollbildmodus präsentieren. In dieser Situation schlägt SetRotation nicht fehl, aber Sie müssen sicherstellen, dass Sie keine Drehung (DXGI_MODE_ROTATION_IDENTITY) für die Swapchain angeben. Andernfalls schlägt die Präsentation fehl, wenn Sie IDXGISwapChain1::P resent1 oder IDXGISwapChain::P resent aufrufen, um einen Frame zu präsentieren.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dxgi1_2.h |
| Bibliothek | Dxgi.lib |