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プロパティ値
指定された 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 への入力として使用されるフェンスに待機を配置するために使用できることです。