IDirect3DMobileDevice::TestCooperativeLevel (Windows CE 5.0)

Send Feedback

This method reports the current cooperative-level status of the Microsoft® Direct3D Mobile® device for a windowed or full-screen application.

HRESULT TestCooperativeLevel();

Parameters

None.

Return Values

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be one of the following D3DMERR Values.

  • D3DMERR_DEVICELOST
  • D3DMERR_DEVICENOTRESET

Remarks

If the device is lost but cannot be restored at the current time, IDirect3DMobileDevice::TestCooperativeLevel returns the D3DMERR_DEVICELOST return code. This would be the case, for example, when a full-screen device has lost focus. If an application detects a lost device, it should pause and periodically call IDirect3DMobileDevice::TestCooperativeLevel until it receives a return value of D3DMERR_DEVICENOTRESET.

The application may then attempt to reset the device by calling IDirect3DMobileDevice::Reset and, if this succeeds, restoring the necessary resources and resume normal operation. Note that IDirect3DMobileDevice::Present will return D3DMERR_DEVICELOST if the device is either "lost" or "not reset."

A call to IDirect3DMobileDevice::TestCooperative Level will fail if called on a different thread than that used to create the device being reset.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobileDevice | IDirect3DMobileDevice::Reset | IDirect3DMobileDevice::Present

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.