DisplayManager 类

定义

命名空间:

Windows.Devices.Display.Core

管理 DisplayTarget 对象的所有权，并提供创建 DisplayState 对象的方法。

public ref class DisplayManager sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayManager final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayManager : System.IDisposable

Public NotInheritable Class DisplayManager
Implements IDisposable

继承

Object Platform::Object IInspectable DisplayManager

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

注解

此对象实现 IClosable/IDisposable，在不再使用所有 DisplayTarget 对象后，该对象应用于撤销其所有权。

方法

Close()	撤销此 DisplayManager 实例拥有的所有 DisplayTarget 对象的所有权。
Create(DisplayManagerOptions)	使用指定选项创建 DisplayManager 实例。
CreateDisplayDevice(DisplayAdapter)	为给定适配器创建 DisplayDevice 对象。 DisplayDevice 可用于创建全屏内容并将其呈现给给定适配器上的目标。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
GetCurrentAdapters()	枚举系统上当前存在的一组显示适配器。
GetCurrentTargets()	枚举系统上当前存在的一组显示目标。
ReleaseTarget(DisplayTarget)	释放指定显示目标的所有权，允许系统上的其他组件获取所有权。
Start()	开始以原子方式侦听所有 DisplayManager 事件。 在你调用 Start 之前，不会引发 DisplayManager 事件。
Stop()	停止以原子方式侦听所有 DisplayManager 事件，并同步触发 Disabled 。
TryAcquireTarget(DisplayTarget)	尝试获取 DisplayTarget 的独占所有权。
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>)	尝试获取 DisplayTarget 对象集合的独占所有权，并创建一个空的可修改 DisplayState 对象，该对象支持连接到这些目标的路径。
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>)	尝试获取 DisplayTarget 对象集合的独占所有权，并仅为传递给此方法的目标划分给定 DisplayState 的子集。 可以修改和应用生成的状态。
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>)	尝试获取 DisplayTarget 对象集合的独占所有权，并创建使用所提供目标的当前状态填充的可修改 DisplayState 。
TryReadCurrentStateForAllTargets()	创建使用所有目标的整个系统显示状态填充的只读 DisplayState 对象。

事件

Changed	添加、删除或修改系统显示硬件时引发的事件。 每当 DisplayAdapter 或 DisplayTarget 集合更改时，都可能发生此情况。 使用此事件检测这些更改，并调用 GetCurrentAdapters 和/或 GetCurrentTargets 以获取更新的集合。
Disabled	每当禁用当前会话的显示堆栈时，以及调用 DisplayManager.Stop 时引发的事件。 可以在多种情况下禁用会话显示堆栈，例如切换终端服务会话，或从驱动程序故障中恢复。 建议订阅服务器尝试在调用 Disabled 时进行清理。 禁用会话显示堆栈时，大多数显示 API 都会失败。
Enabled	每当启用当前会话的显示堆栈并调用 DisplayManager.Start 时引发的事件。 可以在多种情况下重新启用会话显示堆栈，例如切换终端服务会话，或从驱动程序故障中恢复。 我们建议订阅者重新枚举此调用中的所有目标和状态，因为在引发此事件之前，系统显示堆栈可能处于任何状态。
PathsFailedOrInvalidated	每当系统异步显示路径失败或失效时引发的事件。 这可能是由于硬件带宽要求发生变化，也可能是由于驱动程序故障造成的。 此事件的订阅者应为其拥有的目标调用 TryAcquireTargetsAndReadCurrentState，并检查结果 DisplayState 对象中的任何路径是否将其 Status 属性设置为 FailedAsync 或 InvalidatedAsync，并执行建议的操作。