DisplayTaskResult.PresentId プロパティ

定義

名前空間:

Windows.Devices.Display.Core

指定した 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

指定された DisplayTaskPool で要求されたプレゼントの数を表す UINT64 型識別子。

注釈

返される値は、TryExecuteTask が DisplayTaskResult.PresentStatus で DisplayPresentStatus.Succeeded を返したかどうかに関係なく、特定の DisplayTaskPool.TryExecuteTask の呼び出しごとに 1 ずつ単調にインクリメントされます。

PresentId がインクリメントされない唯一のシナリオは、無効なパラメーターで TryExecuteTask を呼び出し、DirectDisplay ランタイム検証がカーネルに呼び出される前に失敗するシナリオです。 このような場合、 TryExecuteTask はすぐに失敗し、HRESULT を返します。 新しい DisplayTaskPool オブジェクトの場合、 PresentId は 0 にリセットされ、最初の TryExecuteTask は 1 の PresentId を 返します。

PresentId の一般的な使用法の 1 つは、DisplayTask.SetSignal への入力として使用されるフェンスに待機を配置するために使用できることです。

こちらもご覧ください

• DisplayTaskPool
• TryExecuteTask(DisplayTask)
• DisplayPresentStatus
• PresentStatus
• SetSignal(DisplayTaskSignalKind, DisplayFence)