Метод 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, запрос не отменяется, если запрос впоследствии не станет отменяемым.

Если драйвер ранее зарегистрировал интерфейс IRequestCallbackRequestCompletion для процедуры завершения запроса, платформа вызывает подпрограмму завершения после отмены запроса.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

См. также раздел

IRequestCallbackCancel::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest::MarkCancelable

IWDFIoRequest::Send