// ks.h
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
);
View the official Windows Driver Kit DDI referenceNo description available.
The KsDispatchFastIoDeviceControlFailure function is used in a KSDISPATCH_TABLE.FastDeviceIoControl entry that are not handled. The function should always return FALSE.
FileObject [in]Not used.
Wait [in]Not used.
InputBuffer [in, optional]Not used.
InputBufferLength [in]Not used.
OutputBuffer [out, optional]Not used.
OutputBufferLength [in]Not used.
IoControlCode [in]Not used.
IoStatus [out]Not used.
DeviceObject [in]Not used.
The KsDispatchFastIoDeviceControlFailure function returns FALSE.
The KsDispatchFastIoDeviceControlFailure function is needed since the dispatch table for a particular opened instance of a device may not handle a specific major function that another opened instance needs to handle. Therefore, the function pointer in the driver object must always point to a function, such as the KsDispatchFastIoDeviceControlFailure function, that calls a dispatch table entry.