Метод IPresentationManager::CancelPresentsFrom (presentation.h)
Отменяет все ранее выданные и все еще имеющиеся в полете подарки, которые еще не отображаются и идентификаторы которых являются по крайней мере переданными в presentIdToCancelFrom.
Синтаксис
HRESULT CancelPresentsFrom(
UINT64 presentIdToCancelFrom
);
Параметры
presentIdToCancelFrom
Тип: UINT64
Идентификатор настоящего объекта, из которого отменяются подарки, которые были выданы, но еще не отображены.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OKзначение ; в противном случае возвращается HRESULT значение, указывающее на ошибку.
Комментарии
Если какие-либо подарки в прошлом уже были отображены, этот вызов не завершится ошибкой - эти подарки просто не будут отменены. Текущий преграда, снятый с учета, не будет отображаться для каких-либо отмененных подарков, так как при отмене подарков они не влияют на текущий отображаемый подарок или не приводят к его началу процесса снятия с учета. По этой причине рекомендуется, чтобы после выполнения презентации приложение запросит доступные события буфера, чтобы найти доступный буфер, который будет выдаваться в первом представлении после отмены. После того как этот элемент помещается в очередь, он позволяет отображаемой ранее презентации начать процесс снятия с учета и сигнализировать о нынешнем заборе с прекращением использования.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Сборка Windows 22000 |
| Минимальная версия сервера | Сборка Windows 22000 |
| Верхняя часть | presentation.h |
| Библиотека | dcomp.lib |
| DLL | dcomp.dll |