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 |