IDXGIOutput::SetDisplaySurface-Methode (dxgi.h)

Ändert den Anzeigemodus.

Syntax

HRESULT SetDisplaySurface(
  [in] IDXGISurface *pScanoutSurface
);

Parameter

[in] pScanoutSurface

Typ: IDXGISurface*

Ein Zeiger auf eine Oberfläche (siehe IDXGISurface), die zum Rendern eines Bilds auf dem Bildschirm verwendet wird. Die Oberfläche muss als Hintergrundpuffer (DXGI_USAGE_BACKBUFFER) erstellt worden sein.

Rückgabewert

Typ: HRESULT

Gibt einen der DXGI_ERROR Werte zurück.

Hinweise

IDXGIOutput::SetDisplaySurface sollte nicht direkt von Anwendungen aufgerufen werden, da die Ergebnisse unvorhersehbar sind. Es wird implizit vom DXGI-Swapchainobjekt während Vollbildübergängen aufgerufen und sollte nicht als Ersatz für Swapchainmethoden verwendet werden.

Diese Methode sollte nur zwischen IDXGIOutput::TakeOwnership - und IDXGIOutput::ReleaseOwnership-Aufrufen aufgerufen werden.

Hinweise für Windows Store-Apps

Wenn eine Windows Store-App SetDisplaySurface verwendet, schlägt sie mit DXGI_ERROR_NOT_CURRENTLY_AVAILABLE fehl.

Anforderungen

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

Weitere Informationen

IDXGIOutput