Share via

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