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


Функция WdfDeviceWdmDispatchIrp (wdfdevice.h)

[Относится к KMDF и UMDF]

Метод WdfDeviceWdmDispatchIrp возвращает в платформу отправленное IRP из EvtDeviceWdmIrpDispatch.

Синтаксис

NTSTATUS WdfDeviceWdmDispatchIrp(
  [in] WDFDEVICE  Device,
  [in] PIRP       Irp,
  [in] WDFCONTEXT DispatchContext
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] Irp

Указатель на структуру IRP.

[in] DispatchContext

Параметр контекста диспетчеризации, полученный драйвером при обратном вызове EvtDeviceWdmIrpDispatch .

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

Метод WdfDeviceWdmDispatchIrp возвращает значение NTSTATUS, предоставленное платформой или драйвером в результате обработки IRP. Драйвер должен использовать это возвращаемое значение в качестве возвращаемого значения для функции обратного вызова EvtDeviceWdmIrpDispatch, которая вызвала WdfDeviceWdmDispatchIrp.

Ошибка проверка возникает, если драйвер KMDF предоставляет недопустимый дескриптор объекта. Если драйвер UMDF предоставляет недопустимый дескриптор, процесс узла драйвера завершается.

Комментарии

Если драйвер предоставляет функцию обратного вызова EvtDeviceWdmIrpDispatch , вы можете вызвать WdfDeviceWdmDispatchIrp из функции обратного вызова, чтобы вернуть IRP в платформу для обработки по умолчанию вместо отправки в определенную очередь.

Дополнительные сведения об указании очередей для поставщиков интеграции по мере их поступления см. в разделе Отправка irPs в очереди ввода-вывода.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.11
Минимальная версия UMDF 2.17
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf)

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

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue