DisplayTaskResult.PresentId 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取一个值,该值表示在给定 DisplayTaskPool 上请求的呈现数。
public:
property unsigned long long PresentId { unsigned long long get(); };
uint64_t PresentId();
public ulong PresentId { get; }
var uInt64 = displayTaskResult.presentId;
Public ReadOnly Property PresentId As ULong
属性值
一个 UINT64 类型标识符,表示在给定 DisplayTaskPool 上请求的演示数。
注解
对于给定DisplayTaskPool,每次调用 DisplayTaskPool.TryExecuteTask 时,返回的值单调递增 1,无论 TryExecuteTask 是否在 DisplayTaskResult.PresentStatus 中返回 DisplayPresentStatus.Succeeded。
PresentId 不会递增的唯一方案是使用无效参数调用 TryExecuteTask,并且 DirectDisplay 运行时验证在调用内核之前失败。 在这些情况下, TryExecuteTask 将立即失败,并返回 HRESULT。 对于新的 DisplayTaskPool 对象, PresentId 将重置为 0,第一个 TryExecuteTask 将返回等于 1 的 PresentId 。
PresentId 的一个常见用法是,可以使用它等待用作 DisplayTask.SetSignal 输入的围栏。