DisplayTaskResult.PresentId 属性

定义

获取一个值,该值表示在给定 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

unsigned long long

uint64_t

一个 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 输入的围栏。

适用于

另请参阅