IDXGIFactory2::RegisterOcclusionStatusEvent 方法 (dxgi1_2.h)
使用事件信号注册以接收有关封闭状态更改的通知。
语法
HRESULT RegisterOcclusionStatusEvent(
[in] HANDLE hEvent,
[out] DWORD *pdwCookie
);
参数
[in] hEvent
发生封闭状态更改通知时操作系统设置的事件对象的句柄。 CreateEvent 或 OpenEvent 函数返回此句柄。
[out] pdwCookie
指向应用程序可以传递给 IDXGIFactory2::UnregisterOcclusionStatus 方法的键值的指针,用于取消注册 hEvent 指定的通知事件。
返回值
RegisterOcclusionStatusEvent 返回:
- S_OK 方法是否成功注册事件。
- E_OUTOFMEMORY内存不可用以完成操作。
- DXGI_ERROR_INVALID_CALLhEvent 是否不是有效的句柄或事件句柄。
- 可能是 DXGI_ERROR 主题中描述的其他错误代码。
适用于 Windows 7 的平台更新: 在安装了适用于 Windows 7 的平台更新的 Windows 7 或 Windows Server 2008 R2 上, RegisterOcclusionStatusEvent 失败并E_NOTIMPL。 有关适用于 Windows 7 的平台更新的详细信息,请参阅 适用于 Windows 7 的平台更新。
备注
如果使用同一事件句柄多次调用 RegisterOcclusionStatusEvent , 则 RegisterOcclusionStatusEvent 将失败并 DXGI_ERROR_INVALID_CALL。
如果使用不同的事件句柄多次调用 RegisterOcclusionStatusEvent , RegisterOcclusionStatusEvent 会正确注册事件。
要求
最低受支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dxgi1_2.h |
Library | Dxgi.lib |