Метод 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 (include D3D9.h)
Библиотека D3D9.lib

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

IDirect3DDevice9