IDirect3DDevice9::TestCooperativeLevel 方法 (d3d9helper.h)
报告窗口或全屏应用程序的 Direct3D 设备的当前合作级别状态。
语法
HRESULT TestCooperativeLevel();
返回值
类型: HRESULT
如果方法成功,则返回值为D3D_OK,表示设备正常运行,并且调用应用程序可以继续。 如果方法失败,则返回值可以是以下值之一:D3DERR_DEVICELOST、D3DERR_DEVICENOTRESET D3DERR_DRIVERINTERNALERROR。
注解
如果设备丢失,但无法在当前时间还原, IDirect3DDevice9::TestCooperativeLevel 将返回D3DERR_DEVICELOST返回代码。 例如,当全屏设备失去焦点时,就会发生这种情况。 如果应用程序检测到丢失的设备,应暂停并定期调用 IDirect3DDevice9::TestCooperativeLevel ,直到收到D3DERR_DEVICENOTRESET的返回值。 然后,应用程序可能会尝试通过调用 IDirect3DDevice9::Reset 来重置设备,如果成功,请还原必要的资源并恢复正常操作。 请注意,如果设备“丢失”或“未重置”, IDirect3DDevice9::P resent 将返回D3DERR_DEVICELOST。
如果在与用于创建重置设备的线程不同的线程上调用 IDirect3DDevice9::TestCooperativeLevel,则调用 IDirect3DDevice9::TestCooperativeLevel 将失败。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d3d9helper.h (包括 D3D9.h) |
Library | D3D9.lib |