DisplayTaskResult.PresentId Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, представляющее количество представлений, запрошенных в заданном пуле 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.
Комментарии
Возвращаемое значение монотонно увеличивается на 1 при каждом вызове DisplayTaskPool.TryExecuteTask для заданного объекта DisplayTaskPool, независимо от того, возвращал ли элемент TryExecuteTaskDisplayPresentStatus.Succeeded в DisplayTaskResult.PresentStatus.
Единственный сценарий, в котором PresentId не увеличивается, — это вызов TryExecuteTask с недопустимыми параметрами, а проверка среды выполнения DirectDisplay завершается сбоем перед вызовом в ядро. В таких случаях TryExecuteTask сразу же завершится сбоем и возвращает HRESULT. Для нового объекта DisplayTaskPoolЗначение PresentId будет сброшено до 0, а самый первый tryExecuteTask вернет Значение PresentId , равное 1.
Один из распространенных способов использования PresentId заключается в том, что его можно использовать для ожидания забора, используемого в качестве входных данных в DisplayTask.SetSignal.