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