Метод IDirect3DDevice9Ex::CheckDeviceState (d3d9.h)

Сообщает текущее состояние устройства Direct3D совместного уровня для оконного или полноэкранного приложения.

Синтаксис

HRESULT CheckDeviceState(
  [in] HWND hDestinationWindow
);

Параметры

[in] hDestinationWindow

Тип: HWND

Дескриптор окна назначения для проверка для окклюзии. Если этот параметр имеет значение NULL, S_PRESENT_OCCLUDED возвращается, когда другое устройство имеет право владения полноэкранным режимом. Если дескриптор окна не равен NULL, клиентская область окна проверяется на наличие окклюзии. Окно заключается, если какая-либо его часть скрыта другим приложением.

Возвращаемое значение

Тип: HRESULT

Возможные возвращаемые значения: D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED или D3DERR_OUTOFVIDEOMEMORY (см . раздел D3DERR), S_PRESENT_MODE_CHANGED или S_PRESENT_OCCLUDED (см . S_PRESENT).

Комментарии

Этот метод заменяет IDirect3DDevice9::TestCooperativeLevel, который всегда возвращает S_OK в приложениях Direct3D 9Ex.

Не рекомендуется вызывать CheckDeviceState для каждого кадра. Вместо этого вызовите CheckDeviceState , только если метод IDirect3Ddevice9Ex::P resentEx возвращает код сбоя.

Дополнительные сведения об утерянных, зависавших и удаленных устройствах см. в разделе Изменения поведения потерянных устройств.

Требования

Целевая платформа	Windows
Header	d3d9.h
Библиотека	D3D9.lib

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

IDirect3DDevice9Ex