перечисление WDF_IO_TARGET_SENT_IO_ACTION (wdfiotarget.h)

  • Статья

[Применимо к KMDF и UMDF]

Перечисление WDF_IO_TARGET_SENT_IO_ACTION определяет действия, которые может предпринять платформа, когда драйвер вызывает WdfIoTargetStop для остановки целевого объекта ввода-вывода.

Синтаксис

typedef enum _WDF_IO_TARGET_SENT_IO_ACTION {
  WdfIoTargetSentIoUndefined = 0,
  WdfIoTargetCancelSentIo,
  WdfIoTargetWaitForSentIoToComplete,
  WdfIoTargetLeaveSentIoPending
} WDF_IO_TARGET_SENT_IO_ACTION;

Константы

 
WdfIoTargetSentIoUndefined
Значение: 0
Зарезервировано для системного использования.
WdfIoTargetCancelSentIo
Прежде чем платформа остановит целевой объект ввода-вывода, она попытается отменить запросы ввода-вывода, которые находятся в очереди целевого объекта ввода-вывода. Платформа отменяет все запросы ввода-вывода целевой очереди и ожидает завершения всех запросов ввода-вывода, прежде чем вернет WdfIoTargetStop . Платформа также пытается отменить запросы ввода-вывода, которые покинули очередь целевого объекта ввода-вывода и вошли в более низкие драйверы.
WdfIoTargetWaitForSentIoToComplete
Прежде чем платформа остановит целевой объект ввода-вывода, она будет ожидать завершения запросов ввода-вывода, которые находятся в очереди целевого объекта ввода-вывода. Платформа выполняет все запросы ввода-вывода целевой очереди и вызывает функцию обратного вызова CompletionRoutine каждого запроса до возврата WdfIoTargetStop .
WdfIoTargetLeaveSentIoPending
Платформа оставит запросы ввода-вывода в очереди целевого объекта ввода-вывода. Запросы остаются в очереди целевого объекта, пока драйвер не вызовет WdfIoTargetStart или устройство не будет удалено.

Комментарии

Перечисление WDF_IO_TARGET_SENT_IO_ACTION используется в качестве входного параметра метода WdfIoTargetStop .

Если драйвер задает флаг WdfIoTargetWaitForSentIoToComplete , драйвер не должен вызывать WdfIoTargetStop из обработчика запросов, функции обратного вызова CompletionRoutine или функции обратного вызова EvtUsbTargetPipeReadersFailed .

Версию UMDF этого перечисления см. в разделе WDF_IO_TARGET_SENT_IO_ACTION (UMDF).

Требования

Требование Значение
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfiotarget.h (включая Wdf.h)

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

CompletionRoutine

WdfIoTargetStop