Метод 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 для запроса ввода-вывода.
Возвращаемое значение
Никакой
Замечания
Драйвер регистрирует интерфейс очереди ввода-вывода IQueueCallbackIoCanceledOnQueue и функцию обратного вызова OnIoCanceledOnQueue при вызове драйвера IWDFDevice::CreateIoQueue. Дополнительные сведения о регистрации интерфейса см. в IQueueCallbackIoCanceledOnQueue.
Если драйвер регистрирует функцию обратного вызова OnIoCanceledOnQueue для очереди ввода-вывода, платформа вызывает функцию обратного вызова, если обработчик запросов получает запрос ввода-вывода из очереди ввода-вывода, драйвер вызывает IWDFIoRequest::ForwardToIoQueue или IWDFIoRequest2::Requeue, чтобы повторно отправить запрос в очередь ввода-вывода, для которой зарегистрирована функция обратного вызова OnIoCanceledOnQueue, и связанная операция ввода-вывода впоследствии отменена.
Когда платформа вызывает функцию обратного вызова OnIoCanceledOnQueue, драйвер владеет объектом запроса и, следовательно, должен отмене запросе.
Платформа не вызывает функцию обратного вызова драйвера OnIoCanceledOnQueue для запросов ввода-вывода, которые платформа никогда не доставляла драйверу.
Платформа вызывает функцию обратного вызова OnIoCanceledOnQueue, как только она определяет, что запрос ввода-вывода был отменен независимо от метода отправки, что драйвер установил для очереди ввода-вывода. Поэтому платформа может вызывать функцию обратного вызова onIoCanceledOnQueue OnIoCanceledOnQueue для запроса в очереди, использующей последовательную диспетчеризацию, даже если драйвер в настоящее время владеет другим запросом из очереди.
Дополнительные сведения о функции обратного вызова OnIoCanceledOnQueue см. в разделе Отмена запросов ввода-вывода.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.9 |
| заголовка | wudfddi.h (include Wudfddi.h) |