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

请参阅

IDXGIFactory2