IDirect3DDevice8::TestCooperativeLevel
This method reports the current cooperative-level status of the Microsoft® Direct3D® device for a windowed or full-screen application.
HRESULT TestCooperativeLevel();
Parameters
None.
Return Values
If the method succeeds, the return value is D3D_OK, indicating that the device is operational and the calling application can continue.
If the method fails, the return value can be one of the following values (see Remarks):
Remarks
If the device is lost but cannot be restored at the current time, IDirect3DDevice8::TestCooperativeLevel returns the D3DERR_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 TestCooperativeLevel until it receives a return value of D3DERR_DEVICENOTRESET. The application may then attempt to reset the device by calling IDirect3DDevice8::Reset and, if this succeeds, restore the necessary resources and resume normal operation. Note that IDirect3DDevice8::Present will return D3DERR_DEVICELOST if the device is either "lost" or "not reset".
A call to TestCooperative Level will fail if called on a different thread than that used to create the device being reset.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.
See Also
IDirect3DDevice8::Present | IDirect3DDevice8::Reset | IDirect3DDevice8::TestCooperativeLevel | IDirect3DDevice8
Last updated on Thursday, April 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.