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

Weitere Informationen

IDXGISwapChain1