Метод 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

См. также раздел

IDirect3DDevice9