DisplayTaskResult.PresentId Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une valeur représentant le nombre de cadeaux qui ont été demandés sur un DisplayTaskPool donné.
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 ULongValeur de propriété
Identificateur de type UINT64 représentant le nombre de cadeaux qui ont été demandés sur un DisplayTaskPool donné.
Remarques
La valeur retournée s’incrémente de façon monotonique de 1 à chaque appel à DisplayTaskPool.TryExecuteTask pour un DisplayTaskPool donné, que le TryExecuteTask ait retourné DisplayPresentStatus.Succeeded dans DisplayTaskResult.PresentStatus.
Le seul scénario dans lequel PresentId ne sera pas incrémenté est celui où vous appelez TryExecuteTask avec des paramètres non valides, et où la validation du runtime DirectDisplay échoue avant d’appeler le noyau. Dans ce cas, TryExecuteTask échoue immédiatement et retourne un HRESULT. Pour un nouvel objet DisplayTaskPool , PresentId est réinitialisé à 0, et le tout premier TryExecuteTask retourne un PresentId égal à 1.
L’une des utilisations courantes de PresentId est que vous pouvez l’utiliser pour placer une attente sur une clôture utilisée comme entrée dans DisplayTask.SetSignal.