Skip to main content

XDisplayCloseTimeoutDeferralHandle

釋放先前透過呼叫 XDisplayAcquireTimeoutDeferral 所取得的螢幕逾時延遲。

語法

參數

handle   _In_
類型:XDisplayTimeoutDeferralHandle
要關閉之螢幕逾時延遲的控制代碼。

傳回值

類型:void

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
螢幕逾時延遲可確保螢幕在使用者無動作期間不會變暗、鎖定或關閉電源。經過一定的閒置時間後,就會發生螢幕逾時。為回應螢幕逾時,裝置可能會將顯示器調暗、啟動鎖定畫面或關閉顯示器電源。發生螢幕逾時前所需的閒置時間取決於裝置的使用者設定。如果您的遊戲正在執行不需要使用者互動的活動 (例如載入遊戲資源或顯示較長的過場動畫),螢幕逾時可能會造成不便。您可以透過取得螢幕逾時延遲來防止螢幕逾時。 若要取得螢幕逾時延遲,請先呼叫 XDisplayAcquireTimeoutDeferral 以取得螢幕逾時延遲的控制代碼,然後在不再需要控制代碼時呼叫 XDisplayCloseTimeoutDeferralHandle 將其關閉。如果遊戲失去焦點,螢幕逾時延遲會被忽略;如果遊戲結束,螢幕逾時延遲則會被釋放。
如果您使用 XDisplayAcquireTimeoutDeferral 取得螢幕逾時延遲控制代碼,就必須呼叫此函式來關閉該控制代碼。可以取得多個螢幕逾時延遲控制代碼,而且只有在所有螢幕逾時延遲控制代碼都關閉之後,才會為遊戲啟用螢幕逾時。
下列範例會在呼叫 XDisplayAcquireTimeoutDeferral 取得新的螢幕逾時延遲控制代碼之後,播放一段較長的開場過場動畫。如果成功取得新的控制代碼,較長的開場過場動畫就可以播放,而不會因為使用者無動作而發生螢幕逾時。過場動畫播放完畢後,範例會呼叫 XDisplayCloseTimeoutDeferralHandle 來關閉控制代碼。所有螢幕逾時延遲控制代碼都關閉之後,就可能再次因為使用者無動作而發生螢幕逾時。

需求

標頭: XDisplay.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XDisplayAcquireTimeoutDeferral
XDisplay
Last modified on October 6, 2026