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。
  • 如果hEvent 不是有效的控制碼或事件控制碼，DXGI_ERROR_INVALID_CALL。
  • 可能是 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 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dxgi1_2.h
程式庫 Dxgi.lib

另請參閱

IDXGIFactory2