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