Skip to main content

XDisplayCloseTimeoutDeferralHandle

释放先前通过调用 XDisplayAcquireTimeoutDeferral 获取的屏幕超时延迟。

Syntax

Parameters

handle   _In_
类型:XDisplayTimeoutDeferralHandle
要关闭的屏幕超时延迟的句柄。

Return value

类型:void

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
屏幕超时延迟可确保在用户不操作期间屏幕不会变暗、锁定或关闭。经过一段空闲时间后,会发生屏幕超时。响应屏幕超时时,设备可能会使显示器变暗、激活锁屏或关闭显示器。发生屏幕超时前所需的空闲时间取决于设备的用户设置。如果游戏正在执行不需要用户交互的活动(如加载游戏资源或显示长过场动画),屏幕超时可能会带来不便。可以通过获取屏幕超时延迟来防止屏幕超时。 若要获取屏幕超时延迟,请先调用 XDisplayAcquireTimeoutDeferral 获取屏幕超时延迟句柄,然后在不再需要该句柄时调用 XDisplayCloseTimeoutDeferralHandle 关闭它。如果游戏失去焦点,屏幕超时延迟将被忽略,并且当游戏退出时它们将被释放。
如果使用 XDisplayAcquireTimeoutDeferral 获取屏幕超时延迟句柄,则必须通过调用此函数关闭该句柄。可以获取多个屏幕超时延迟句柄,仅当所有屏幕超时延迟句柄都关闭后,才会为游戏启用屏幕超时。
下面的示例在调用 XDisplayAcquireTimeoutDeferral 获取新的屏幕超时延迟句柄后播放较长的介绍过场动画。如果成功获取新句柄,长介绍过场动画就可以播放,而不会因用户不操作而导致屏幕超时。过场动画播放完毕后,示例调用 XDisplayCloseTimeoutDeferralHandle 关闭句柄。所有屏幕超时延迟句柄都关闭后,屏幕超时可以在用户不操作时再次发生。

Requirements

头文件: XDisplay.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XDisplayAcquireTimeoutDeferral
XDisplay
最后修改于 2026年8月24日