共用方式為


IDXGIFactory2::RegisterOcclusionStatusEvent 方法 (dxgi1_2.h)

使用事件訊號註冊以接收遮蔽狀態變更的通知。

語法

HRESULT RegisterOcclusionStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

參數

[in] hEvent

當發生遮蔽狀態變更通知時,作業系統所設定之事件物件的控制碼。 CreateEventOpenEvent函式會傳回此控制碼。

[out] pdwCookie

應用程式可以傳遞至 IDXGIFactory2::UnregisterOcclusionStatus 方法的索引鍵值指標,以取消註冊 hEvent 所指定的通知事件。

傳回值

RegisterOcclusionStatusEvent 會傳回:

  • 如果 方法已成功註冊事件,S_OK。
  • 如果記憶體無法完成作業,E_OUTOFMEMORY。
  • 如果hEvent 不是有效的控制碼或事件控制碼,DXGI_ERROR_INVALID_CALL。
  • 可能是 DXGI_ERROR 主題中所述的其他錯誤碼。

Windows 7 的平臺更新: 在已安裝 Windows 7 平臺更新 的 Windows 7 或 Windows Server 2008 R2 上, RegisterOcclusionStatusEvent 會失敗並E_NOTIMPL。 如需 Windows 7 平臺更新的詳細資訊,請參閱 適用于 Windows 7 的平臺更新

備註

如果您使用相同的事件控制碼多次呼叫 RegisterOcclusionStatusEventRegisterOcclusionStatusEvent 會失敗 並DXGI_ERROR_INVALID_CALL

如果您使用不同的事件控制碼多次呼叫 RegisterOcclusionStatusEventRegisterOcclusionStatusEvent 就會正確註冊事件。

需求

   
最低支援的用戶端 適用于 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dxgi1_2.h
程式庫 Dxgi.lib

另請參閱

IDXGIFactory2