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::TestCocolLevel,其一律會在 Direct3D 9Ex 應用程式中傳回S_OK。
不建議呼叫 CheckDeviceState 每個畫面。 而是只有在IDirect3DDevice9Ex::P resentEx方法傳回失敗碼時,才呼叫CheckDeviceState。
如需遺失、無回應和移除裝置的詳細資訊,請參閱 遺失裝置行為變更 。
需求
目標平台 | Windows |
標頭 | d3d9.h |
程式庫 | D3D9.lib |