Reset Method
Collapse the table of content
Expand the table of content

GraphicsDevice.Reset Method

Resets the presentation parameters for the current GraphicsDevice.

GraphicsDevice.Reset ()Resets the presentation parameters for the current GraphicsDevice.
GraphicsDevice.Reset (GraphicsAdapter)Resets the presentation parameters for the specified Reset.
GraphicsDevice.Reset (PresentationParameters)Resets the current GraphicsDevice with the specified PresentationParameters.
GraphicsDevice.Reset (PresentationParameters, GraphicsAdapter)Resets the specified Reset with the specified presentation parameters.

Exception typeCondition
DeviceLostExceptionThe GraphicsDevice is lost but cannot be reset at this time. Therefore, rendering is not possible.
DriverInternalErrorExceptionInternal driver error. Applications should generally shut down when receiving this error.
OutOfVideoMemoryExceptionDirect3D does not have enough display memory to perform the operation.
OutOfMemoryExceptionDirect3D could not allocate sufficient memory to complete the call.

When switching to full screen mode, Microsoft Direct3D tries to find a desktop format that matches the back buffer format, so that back and front buffer formats are identical. This eliminates the need for color conversion.

Calling Reset causes all texture memory surfaces and state information to be lost, and managed textures to be flushed from video memory. Before calling Reset for a GraphicsDevice, an application should release any explicit render targets, depth stencil surfaces, additional swap chains, state blocks, and default resources associated with the GraphicsDevice.

Swap chains are either full screen or windowed. If the new swap chain is full screen, the adapter is placed in the display mode that matches the new size.

A call to Reset fails if made on a different thread than the one used to create the GraphicsDevice being reset.

Pixel shaders and vertex shaders survive Reset calls for DirectX 9.0. They do not need to be re-created explicitly by the application.

Unknown can be specified for the windowed-mode back-buffer format when creating a GraphicsDevice and Reset. This means the application does not have to query the current desktop format before calling a GraphicsDevice constructor for windowed mode. For full screen mode, the back-buffer format must be specified. Setting BackBufferCount to 0 results in the creation of one back buffer.

When trying to reset more than one display adapter in a group, pass in an array of PresentationParameters objects, one for each display in the adapter group.

Community Additions

© 2016 Microsoft