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,后者始终在 Direct3D 9Ex 应用程序中返回S_OK。

建议不要在每个帧中调用 CheckDeviceState 。 相反,仅当 IDirect3DDevice9Ex::P resentEx 方法返回失败代码时,才调用 CheckDeviceState

有关 丢失、 挂起和已删除的设备的详细信息,请参阅丢失的设备行为更改。

要求

   
目标平台 Windows
标头 d3d9.h
Library D3D9.lib

请参阅

IDirect3DDevice9Ex