DisplayTaskResult.PresentId Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un valor que representa el número de regalos solicitados en un displayTaskPool determinado.
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 de propiedad
Identificador de tipo UINT64 que representa el número de regalos que se han solicitado en un displayTaskPool determinado.
Comentarios
El valor devuelto incrementa monotónicamente en 1 en cada llamada a DisplayTaskPool.TryExecuteTask para un displayTaskPool determinado, independientemente de si el TryExecuteTask devolvió DisplayPresentStatus.Succeeded en DisplayTaskResult.PresentStatus.
El único escenario en el que PresentId no se incrementará es donde se llama a TryExecuteTask con parámetros no válidos y se produce un error en la validación en tiempo de ejecución de DirectDisplay antes de llamar al kernel. En esos casos, TryExecuteTask producirá un error inmediatamente y devolverá un VALOR HRESULT. Para un nuevo objeto DisplayTaskPool , PresentId se restablecerá a 0 y el primer TryExecuteTask devolverá un PresentId igual a 1.
Uno de los usos comunes de PresentId es que puede usarlo para poner una espera en una valla usada como entrada para DisplayTask.SetSignal.