DisplayTaskResult.PresentId Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che rappresenta il numero di regali richiesti in un oggetto DisplayTaskPool specificato.
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
Valore della proprietà
Identificatore del tipo UINT64 che rappresenta il numero di regali richiesti in un oggetto DisplayTaskPool specificato.
Commenti
Il valore restituito incrementa monotonicamente di 1 a ogni chiamata a DisplayTaskPool.TryExecuteTask per un determinato DisplayTaskPool, indipendentemente dal fatto che TryExecuteTask abbia restituito DisplayPresentStatus.Succeeded in DisplayTaskResult.PresentStatus.
L'unico scenario in cui PresentId non verrà incrementato è la posizione in cui si chiama TryExecuteTask con parametri non validi e la convalida del runtime DirectDisplay non riesce prima di chiamare nel kernel. In questi casi , TryExecuteTask avrà esito negativo immediatamente e restituirà un HRESULT. Per un nuovo oggetto DisplayTaskPool , PresentId verrà reimpostato su 0 e il primo tryExecuteTask restituirà un PresentId uguale a 1.
Uno degli utilizzi comuni di PresentId è che è possibile usarlo per mettere un'attesa su un recinto usato come input per DisplayTask.SetSignal.