Метод IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]
Функция обратного вызова события OnIoCanceledOnQueue драйвера сообщает драйверу, что запрос ввода-вывода был отменен, когда он находился в очереди ввода-вывода.
Синтаксис
void OnIoCanceledOnQueue(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest
);
Параметры
[in] pWdfQueue
Указатель на интерфейс IWDFIoQueue для очереди ввода-вывода, в которую входил запрос ввода-вывода при его отмене.
[in] pWdfRequest
Указатель на интерфейс IWDFIoRequest для запроса ввода-вывода.
Возвращаемое значение
None
Remarks
Драйвер регистрирует интерфейс IQueueCallbackIoCanceledOnQueue очереди ввода-вывода и функцию обратного вызова OnIoCanceledOnQueue , когда драйвер вызывает IWDFDevice::CreateIoQueue. Дополнительные сведения о регистрации интерфейса см. в разделе IQueueCallbackIoCanceledOnQueue.
Если драйвер регистрирует функцию обратного вызова OnIoCanceledOnQueue для очереди ввода-вывода, платформа вызывает функцию обратного вызова, если обработчик запросов получает запрос ввода-вывода из очереди ввода-вывода, драйвер вызывает IWDFIoRequest::ForwardToIoQueue или IWDFIoRequest2::Requeue , чтобы повторно отправить запрос в очередь ввода-вывода, для которой зарегистрирована функция обратного вызова OnIoCanceledOnQueue . и связанная операция ввода-вывода впоследствии отменяется.
После того как платформа вызывает функцию обратного вызова OnIoCanceledOnQueue , драйверу принадлежит объект запроса и, следовательно, он должен отменить запрос.
Платформа не вызывает функцию обратного вызова OnIoCanceledOnQueue драйвера для запросов ввода-вывода, которые платформа никогда не доставляла драйверу.
Платформа вызывает функцию обратного вызова OnIoCanceledOnQueue , как только определяет, что запрос ввода-вывода отменен, независимо от метода диспетчеризации , заданного драйвером для очереди ввода-вывода. Таким образом, платформа может вызывать функцию обратного вызова OnIoCanceledOnQueue для запроса в очереди, использующего последовательную диспетчеризацию, даже если драйвер в настоящее время владеет другим запросом из очереди.
Дополнительные сведения о функции обратного вызова OnIoCanceledOnQueue см. в разделе Отмена запросов ввода-вывода.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1,9 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |