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

Функция KsDispatchFastIoDeviceControlFailure используется в KSDISPATCH_TABLE. Запись FastDeviceIoControl, которая не обрабатывается. Функция всегда должна возвращать значение FALSE.

Синтаксис

KSDDKAPI BOOLEAN KsDispatchFastIoDeviceControlFailure(
  [in]            PFILE_OBJECT     FileObject,
  [in]            BOOLEAN          Wait,
  [in, optional]  PVOID            InputBuffer,
  [in]            ULONG            InputBufferLength,
  [out, optional] PVOID            OutputBuffer,
  [in]            ULONG            OutputBufferLength,
  [in]            ULONG            IoControlCode,
  [out]           PIO_STATUS_BLOCK IoStatus,
  [in]            PDEVICE_OBJECT   DeviceObject
);

Параметры

[in] FileObject

Не используется.

[in] Wait

Не используется.

[in, optional] InputBuffer

Не используется.

[in] InputBufferLength

Не используется.

[out, optional] OutputBuffer

Не используется.

[in] OutputBufferLength

Не используется.

[in] IoControlCode

Не используется.

[out] IoStatus

Не используется.

[in] DeviceObject

Не используется.

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

Функция KsDispatchFastIoDeviceControlFailure возвращает значение FALSE.

Комментарии

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

Требования

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