// ks.h
KSDDKAPI BOOLEAN KsDispatchFastReadFailure(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] BOOLEAN Wait,
[in] ULONG LockKey,
[out] PVOID Buffer,
[out] PIO_STATUS_BLOCK IoStatus,
[in] PDEVICE_OBJECT DeviceObject
);
View the official Windows Driver Kit DDI referenceNo description available.
The KsDispatchFastReadFailure function is used in a KSDISPATCH_TABLE.FastRead entry when fast I/O read is not handled. The function should always return FALSE.
FileObject [in]Not used.
FileOffset [in]Not used.
Length [in]Not used.
Wait [in]Not used.
LockKey [in]Not used.
Buffer [out]Not used.
IoStatus [out]Not used.
DeviceObject [in]Not used.
The KsDispatchFastReadFailure function returns FALSE.
The KsDispatchFastReadFailure 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 KsDispatchFastReadFailure function, that calls a dispatch table entry.