Export (0) Print
Expand All

Device.Reset Method

Resets the presentation parameters for the current device.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in microsoft.windowsmobile.directx.dll)

public void Reset (
	PresentParameters presentationParameters
)
public void Reset (
	PresentParameters presentationParameters
)
public function Reset (
	presentationParameters : PresentParameters
)

Parameters

presentationParameters

A PresentParameters structure that describes the new presentation parameters. This value cannot be null.

Exception typeCondition

InvalidCallException

The method call is invalid. For example, a parameter might contain an invalid value.

DriverInternalErrorException

Internal driver error. Applications should generally shut down when receiving this error.

OutOfMemoryException

Direct3D could not allocate sufficient memory to complete the call.

When switching to full-screen mode, 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.

If a call to Reset fails, the device is placed in the "lost" state as indicated by a return value of false from a call to CheckCooperativeLevel unless it is already in the "not reset" state as indicated by a DeviceNotReset returned from the hResult parameter of the CheckCooperativeLevel method.

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 device, an application should release any explicit render targets, depth stencil surfaces, additional swap chains, state blocks, and default resources associated with the device.

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 device being reset.

Unknown can be specified for the windowed mode back buffer format when calling Device, Reset, and SwapChain. This means the application does not have to query the current desktop format before calling Device for windowed mode. For full-screen mode, the back buffer format must be specified. Setting BackBufferCount to 0 creates one back buffer.

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

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Compact Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2015 Microsoft