DisplayTaskResult.PresentId Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um valor que representa o número de presentes que foram solicitados em um determinado 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 ULongValor da propriedade
Um identificador de tipo UINT64 que representa o número de presentes que foram solicitados em um determinado DisplayTaskPool.
Comentários
O valor retornado incrementa monotonicamente em 1 em cada chamada para DisplayTaskPool.TryExecuteTask para um determinado DisplayTaskPool, independentemente de o TryExecuteTask retornar DisplayPresentStatus.Succeeded em DisplayTaskResult.PresentStatus.
O único cenário em que PresentId não será incrementado é quando você chama TryExecuteTask com parâmetros inválidos e a validação do runtime do DirectDisplay falha antes de chamar o kernel. Nesses casos, TryExecuteTask falhará imediatamente e retornará um HRESULT. Para um novo objeto DisplayTaskPool , PresentId será redefinido para 0 e o primeiro TryExecuteTask retornará um PresentId igual a 1.
Um dos usos comuns do PresentId é que você pode usá-lo para aguardar uma cerca usada como entrada para DisplayTask.SetSignal.