Метод 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 завершится ошибкой при вызове в потоке, отличном от потока, используемого для создания сбрасываемого устройства.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | d3d9helper.h (включая D3D9.h) |
Библиотека | D3D9.lib |