Метод IWDFIoRequest2::IsCanceled (wudfddi.h)

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод IsCanceled определяет, пытался ли диспетчер операций ввода-вывода отменить запрос ввода-вывода.

Синтаксис

BOOL IsCanceled();

Возвращаемое значение

IsCanceled возвращает значение TRUE , если диспетчер операций ввода-вывода пытался отменить запрос ввода-вывода. Этот метод возвращает значение FALSE по любой из следующих причин:

• Диспетчер операций ввода-вывода не пытался отменить запрос.
• Вызывающий драйвер не владеет запросом.
• Вызывающий драйвер вызвал метод IWDFIoRequest::MarkCancelable .

Комментарии

Если драйвер не вызывал функцию обратного вызова IWDFIoRequest::MarkCancelable для регистрации функции обратного вызова IRequestCallbackCancel::OnCancel , но если вы хотите, чтобы драйвер определял, пытался ли диспетчер операций ввода-вывода отменить запрос ввода-вывода, драйвер может вызвать IsCanceled.

Драйвер может вызывать IsCanceled для запроса, только если драйвер владеет запросом ввода-вывода. Если драйвер вызвал IWDFIoRequest::MarkCancelable, он должен вызвать IWDFIoRequest::UnmarkCancelable перед вызовомIsCanceled.

Если IsCanceled возвращает значение TRUE, драйвер должен отменить запрос, вызвав IWDFIoRequest::Complete с параметром CompletionStatus , равным HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Дополнительные сведения о IsCanceled см. в разделе Отмена запросов ввода-вывода.

Примеры

В следующем примере кода, если IsCanceled возвращает значение TRUE, драйвер завершает запрос ввода-вывода, вызывая IWDFIoRequest::Complete с состоянием завершения HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

if (fxRequest2->IsCanceled())
{
    fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...

Требования

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

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable