Edit

Share via

KsDispatchFastIoDeviceControlFailure function (ks.h)

  • Article

The KsDispatchFastIoDeviceControlFailure function is used in a KSDISPATCH_TABLE.FastDeviceIoControl entry that are not handled. The function should always return FALSE.

Syntax

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

Parameters

[in] FileObject

Not used.

[in] Wait

Not used.

[in, optional] InputBuffer

Not used.

[in] InputBufferLength

Not used.

[out, optional] OutputBuffer

Not used.

[in] OutputBufferLength

Not used.

[in] IoControlCode

Not used.

[out] IoStatus

Not used.

[in] DeviceObject

Not used.

Return value

The KsDispatchFastIoDeviceControlFailure function returns FALSE.

Remarks

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.

Requirements

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