KsDispatchFastWriteFailure function

The KsDispatchFastWriteFailure function is used in a KSDISPATCH_TABLE.FastWrite entry when fast I/O is not handled for a write operation. The function should always return FALSE.

Syntax

KSDDKAPI BOOLEAN NTAPI KsDispatchFastWriteFailure(
  _In_  PFILE_OBJECT     FileObject,
  _In_  PLARGE_INTEGER   FileOffset,
  _In_  ULONG            Length,
  _In_  BOOLEAN          Wait,
  _In_  ULONG            LockKey,
  _In_  PVOID            Buffer,
  _Out_ PIO_STATUS_BLOCK IoStatus,
  _In_  PDEVICE_OBJECT   DeviceObject
);

Parameters

  • FileObject [in]
    Not used.

  • FileOffset [in]
    Not used.

  • Length [in]
    Not used.

  • Wait [in]
    Not used.

  • LockKey [in]
    Not used.

  • Buffer [in]
    Not used.

  • IoStatus [out]
    Not used.

  • DeviceObject [in]
    Not used.

Return value

The KsDispatchFastWriteFailure function returns FALSE.

Remarks

The KsDispatchFastWriteFailure 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 KsDispatchFastWriteFailure function, that calls a dispatch table entry.

Requirements

Target platform

Desktop

Header

Ks.h (include Ks.h)

 

 

Send comments about this topic to Microsoft