共用方式為


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

另請參閱

IDirect3DDevice9Ex