IDXGISwapChain::ResizeTarget-Methode (dxgi.h)

  • Artikel

Ändert die Größe des Ausgabeziels.

Syntax

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Parameter

[in] pNewTargetParameters

Typ: const DXGI_MODE_DESC*

Ein Zeiger auf eine DXGI_MODE_DESC-Struktur , die den Modus beschreibt, der die neue Breite, Höhe, Das Format und die Aktualisierungsrate des Ziels angibt. Wenn das Format DXGI_FORMAT_UNKNOWN ist, verwendet ResizeTarget das vorhandene Format. Es wird nur empfohlen, DXGI_FORMAT_UNKNOWN zu verwenden, wenn sich die Swapchain im Vollbildmodus befindet, da diese Methode nicht threadsicher ist.

Rückgabewert

Typ: HRESULT

Gibt einen Code zurück, der auf Erfolg oder Fehler hinweist. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS wird zurückgegeben, wenn beim Aufruf dieser API ein Übergang im Vollbild-/Fenstermodus stattfindet. Weitere DXGI-Fehlercodes finden Sie unter DXGI_ERROR .

Hinweise

ÄndertizeTarget ändert die Größe des Zielfensters, wenn sich die Swapchain im Fenstermodus befindet, und ändert den Anzeigemodus für die Zielausgabe, wenn sich die Swapchain im Vollbildmodus befindet. Daher können Apps ResizeTarget aufrufen, um die Größe des Zielfensters (anstelle eines Microsoft Win32API wie SetWindowPos) ohne Kenntnis des Swap chain-Anzeigemodus zu ändern.

Wenn eine Windows Store-App ResizeTarget aufruft, schlägt dies mit DXGI_ERROR_NOT_CURRENTLY_AVAILABLE fehl.

Sie können ResizeTarget nicht in einer Swapchain aufrufen, die Sie mit IDXGIFactory2::CreateSwapChainForComposition erstellt haben.

Apps müssen IDXGISwapChain::ResizeBuffers weiterhin aufrufen, nachdem sie ResizeTarget aufgerufen haben, da nur ResizeBuffers die Backpuffer ändern können. Wenn diese Apps jedoch die Fenstergrößenänderungsverarbeitung implementiert haben, um ResizeBuffers aufzurufen, müssen sie ResizeBuffers nicht explizit aufrufen, nachdem sie ResizeTarget aufgerufen haben, da die Verarbeitung der Fenstergröße das erreicht, was die App benötigt.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

IDXGISwapChain