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 |