Share via

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

另请参阅

IDXGIFactory2