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


Функция 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 в платформу для обработки по умолчанию вместо отправки в определенную очередь.

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

Требования

Требование Ценность
целевая платформа универсальный
минимальная версия KMDF 1.11
минимальная версия UMDF 2.17
Заголовок wdfdevice.h (include Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
правил соответствия DDI DriverCreate(kmdf)

См. также

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue