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

Статья
03/22/2025

[Применимо к 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` Перед остановкой целевого объекта ввода-вывода платформа ожидает завершения запросов ввода-вывода, которые находятся в очереди целевого объекта ввода-вывода. Платформа завершает все запросы ввода-вывода целевой очереди и вызывает функцию обратного вызова завершения каждого запроса, функцию обратного вызова WdfIoTargetStop.
`WdfIoTargetLeaveSentIoPending` Платформа оставляет запросы ввода-вывода в очереди целевого объекта ввода-вывода. Запросы остаются в очереди целевого объекта, пока драйвер не вызовет WdfIoTargetStart или устройство будет удалено.

Замечания

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

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

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

Требования

Требование	Ценность
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdfiotarget.h (include Wdf.h)

См. также

CompletionRoutine

WdfIoTargetStop

Поделиться через