Метод IWDFIoRequest::CancelSentRequest (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод CancelSentRequest пытается отменить запрос ввода-вывода, который драйвер ранее отправил в целевой объект ввода-вывода.
Синтаксис
BOOL CancelSentRequest();
Возвращаемое значение
CancelSentRequest возвращает значение BOOL, указывающее, был ли запрос отмены успешно доставлен владельцу запроса. TRUE указывает, что запрос был успешно доставлен. FALSE указывает, что запрос не был успешно доставлен.
Замечания
Драйвер может вызвать CancelSentRequest попытаться отменить запрос ввода-вывода, который он ранее отправил в целевой объект ввода-вывода, вызвав метод IWDFIoRequest::Send.
Если запрос находится в очереди целевого объекта ввода-вывода, платформа отменяет запрос. Если платформа уже передала запрос драйверу целевого объекта ввода-вывода и если этот драйвер ранее вызывал IWDFIoRequest::MarkCancelable для включения отмены, платформа вызывает этот метод IRequestCallbackCancel::OnCancel. Если драйвер целевого объекта не вызывал IWDFIoRequest::MarkCancelable, запрос не отменяется, если запрос впоследствии не станет отменяемым.
Если драйвер ранее зарегистрировал интерфейс IRequestCallbackRequestComplet ion для подпрограммы завершения запроса, платформа вызывает подпрограмму завершения после отмены запроса.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
См. также
IRequestCallbackCancel::OnCancel