Edit

Share via

KsDispatchFastReadFailure function (ks.h)

  • Article

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.

Syntax

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
);

Parameters

[in] FileObject

Not used.

[in] FileOffset

Not used.

[in] Length

Not used.

[in] Wait

Not used.

[in] LockKey

Not used.

[out] Buffer

Not used.

[out] IoStatus

Not used.

[in] DeviceObject

Not used.

Return value

The KsDispatchFastReadFailure function returns FALSE.

Remarks

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.

Requirements

Requirement Value
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib