IDXGIFactory2::RegisterOcclusionStatusWindow 方法 (dxgi1_2.h)
注册应用程序窗口,以接收有关遮挡状态更改的通知消息。
语法
HRESULT RegisterOcclusionStatusWindow(
[in] HWND WindowHandle,
[in] UINT wMsg,
[out] DWORD *pdwCookie
);
参数
[in] WindowHandle
窗口的句柄,用于在发生遮挡状态更改时向其发送通知消息。
[in] wMsg
标识要发送的通知消息。
[out] pdwCookie
指向键值的指针,应用程序可以传递给 IDXGIFactory2::UnregisterOcclusionStatus 方法,以取消注册 wMsg 指定的通知消息。
返回值
RegisterOcclusionStatusWindow 返回:
- S_OK是否成功注册了窗口。
- 如果内存不可用,则E_OUTOFMEMORY以完成操作。
- DXGI_ERROR_INVALID_CALLWindowHandle 是否不是有效的窗口句柄,或者不是当前进程拥有的窗口句柄。
- 可能是 DXGI_ERROR 主题中描述的其他错误代码。
适用于 Windows 7 的平台更新: 在安装了适用于 Windows 7 的平台更新的 Windows 7 或 Windows Server 2008 R2 上, RegisterOcclusionStatusWindow 失败并出现E_NOTIMPL。 有关 Windows 7 平台更新的详细信息,请参阅 适用于 Windows 7 的平台更新。
注解
应用选择当遮挡状态更改时 Windows 发送的 Windows 消息。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [仅限桌面应用] |
最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [仅限桌面应用] |
目标平台 | Windows |
标头 | dxgi1_2.h |
Library | Dxgi.lib |