Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDXGIOutput::SetDisplaySurface method

Changes the display mode.

Syntax


HRESULT SetDisplaySurface(
  [in] IDXGISurface *pScanoutSurface
);

Parameters

pScanoutSurface [in]

Type: IDXGISurface*

A pointer to a surface (see IDXGISurface) used for rendering an image to the screen. The surface must have been created as a back buffer (DXGI_USAGE_BACKBUFFER).

Return value

Type: HRESULT

Returns one of the DXGI_ERROR values.

Remarks

IDXGIOutput::SetDisplaySurface should not be called directly by applications, since results will be unpredictable. It is called implicitly by the DXGI swap chain object during full-screen transitions, and should not be used as a substitute for swap-chain methods.

This method should only be called between IDXGIOutput::TakeOwnership and IDXGIOutput::ReleaseOwnership calls.

Notes for Windows Store apps

If a Windows Store app uses SetDisplaySurface, it fails with DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIOutput

 

 

Show:
© 2018 Microsoft