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 |