共用方式為


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_CALL 如果 WindowHandle 不是有效的視窗句柄,或不是目前進程所擁有的視窗句柄。
  • 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
程式庫 Dxgi.lib

另請參閱

IDXGIFactory2