Device.Reset Method

Artigo
10/15/2009

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Resets the presentation parameters for the current device.

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

Syntax

'Declaration
Public Sub Reset ( _
    presentationParameters As PresentParameters _
)
'Usage
Dim instance As Device
Dim presentationParameters As PresentParameters

instance.Reset(presentationParameters)

public void Reset(
    PresentParameters presentationParameters
)

public:
void Reset(
    PresentParameters^ presentationParameters
)

member Reset : 
        presentationParameters:PresentParameters -> unit

Parameters

presentationParameters
Type: Microsoft.WindowsMobile.DirectX.Direct3D.PresentParameters
A PresentParameters structure that describes the new presentation parameters. This value cannot be null.

Exceptions

Exception	Condition
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.

Remarks

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.

You can specify "unknown" for the windowed mode back buffer format when you call Device, Reset, and SwapChain. This means that the application does not have to query the current desktop format before calling Device for windowed mode. For full-screen mode, you must specify the back buffer format. 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.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

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

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

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

Compartilhar via