IDXGISwapChain2::SetSourceSize-Methode (dxgi1_3.h)

  • Artikel

Legt die Quellregion fest, die für die Swapchain verwendet werden soll.

Verwenden Sie SetSourceSize , um den Teil der Swapchain anzugeben, aus der das Betriebssystem präsentiert. Dies ermöglicht eine effektive Größenänderung, ohne die teurere IDXGISwapChain::ResizeBuffers-Methode aufzurufen. Vor Windows 8.1 war der Aufruf von IDXGISwapChain::ResizeBuffers die einzige Möglichkeit, die Größe der Swapchain zu ändern. Das Quellrechteck wird immer durch den Bereich [0, 0, Width, Height] definiert.

Syntax

HRESULT SetSourceSize(
  UINT Width,
  UINT Height
);

Parameter

Width

Quellbreite, die für die Swapchain verwendet werden soll. Dieser Wert muss größer als 0 (null) und kleiner oder gleich der Gesamtbreite der Swapchain sein.

Height

Quellhöhe, die für die Swapchain verwendet werden soll. Dieser Wert muss größer als 0 (null) und kleiner oder gleich der Gesamthöhe der Swapchain sein.

Rückgabewert

Diese Methode kann Folgendes zurückgeben:

  • E_INVALIDARG, wenn mindestens ein Parameter die Größe des Rückpuffers überschreitet.
  • Möglicherweise weitere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi1_3.h
Bibliothek Dxgi.lib

Weitere Informationen

GetSourceSize

IDXGISwapChain2