DisplaySourceStatus 枚举

定义

定义常量,这些常量指定显示源 (displaySource 对象) 可以处于的状态。

状态会影响显示源的使用情况,以及它如何影响其他 API 调用。 例如,如果显示源已关闭电源,则预计对 (例如) DisplayTaskPool.TryExecuteTask 的调用不会成功。

public enum class DisplaySourceStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
enum class DisplaySourceStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
public enum DisplaySourceStatus
var value = Windows.Devices.Display.Core.DisplaySourceStatus.active
Public Enum DisplaySourceStatus
继承
DisplaySourceStatus
属性

Windows 要求

设备系列
Windows 11 (在 10.0.22000.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v14.0 中引入)

字段

Active 0

指定显示源连接到 DisplayTarget,并且有效且由给定的 “DisplayDevice”拥有。 此外,这意味着从内核的角度来看,基础显示器的电源状态处于打开状态。 这是正确设置 DisplaySource 并且 DirectDisplay 客户端正在使用进行演示时最常见的状态。

Invalid 2

指定显示源无效,DirectDisplay 客户端需要重新创建 DisplaySource 对象。 DisplaySource 可能由于各种原因而失效;例如,显示模式更改或热插拔检测 (连接的监视器的 HPD) 。

OwnedByAnotherDevice 3

指定显示源当前不归当前 DisplayDevice 所有,并且由其他 DisplayDevice 拥有, (我们将该显示设备称为 A) ,或由其他一些 Direct3D 设备拥有。 如果显示设备 A 具有所有权,则当前 DisplayDevice 可以尝试重新创建显示源 (如果创建显示设备 A 的 DisplayManager 使用了DisplayManagerOptions.None。 如果其他 Direct3D 设备拥有所有权,则如果你认为自己是正确的所有者,你仍然可以尝试重新创建 DisplaySource

PoweredOff 1

指定显示源连接到 DisplayTarget,并且有效且由给定的 DisplayDevice 拥有。 但从内核的角度来看,基础显示器的电源状态已关闭。

Unowned 4

指定显示源当前不归当前 DisplayDevice 所有,并且处于无所有者状态。 在这种情况下,可以尝试重新创建 DisplaySource;这样做会隐式授予你的所有权。

适用于