Функция KsDispatchInvalidDeviceRequest (ks.h)

Функция KsDispatchInvalidDeviceRequest используется в KSDISPATCH_TABLE записях, которые не обрабатываются и которые должны возвращать STATUS_INVALID_DEVICE_REQUEST.

Синтаксис

KSDDKAPI NTSTATUS KsDispatchInvalidDeviceRequest(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Параметры

[in] DeviceObject

Указывает объект устройства, связанный с IRP.

[in] Irp

Указывает IRP, который не обрабатывается.

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

Функция KsDispatchInvalidDeviceRequest возвращает STATUS_INVALID_DEVICE_REQUEST и завершает IRP.

Комментарии

Функция KsDispatchInvalidDeviceRequest необходима, так как таблица диспетчеризации для открытого экземпляра устройства может не обрабатывать определенную основную функцию, которую должен обрабатывать другой открытый экземпляр. Поэтому указатель функции в объекте драйвера всегда должен указывать на функцию, которая вызывает запись таблицы диспетчеризации.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib

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

KsDispatchFastIoDeviceControlFailure

KsDispatchFastReadFailure

KsDispatchFastWriteFailure