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.TryExecuteTaskPool.TryExecuteTaskPool時,傳回的值會以單調方式遞增 1,不論TryExecuteTask是否傳回DisplayPresentStatus.Succeeded in DisplayTaskResult.PresentStatus。
唯一不會遞增 PresentId 的案例是您呼叫具有無效參數 的 TryExecuteTask ,而 DirectDisplay 執行時間驗證會在呼叫核心之前失敗。 在這些情況下, TryExecuteTask 會立即失敗,並傳回 HRESULT。 針對新的 DisplayTaskPool 物件, PresentId 會重設為 0,而第一個 TryExecuteTask 會傳回等於 1 的 PresentId 。
PresentId的其中一個常見用法是,您可以使用它來等候作為DisplayTask.SetSignal輸入的柵欄。