KsDispatchFastIoDeviceControlFailure function

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

Syntax


BOOLEAN KsDispatchFastIoDeviceControlFailure(
  _In_      PFILE_OBJECT     FileObject,
  _In_      BOOLEAN          Wait,
  _In_opt_  PVOID            InputBuffer,
  _In_      ULONG            InputBufferLength,
  _Out_opt_ PVOID            OutputBuffer,
  _In_      ULONG            OutputBufferLength,
  _In_      ULONG            IoControlCode,
  _Out_     PIO_STATUS_BLOCK IoStatus,
  _In_      PDEVICE_OBJECT   DeviceObject
);

Parameters

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.

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

Target platform

Universal

Header

Ks.h (include Ks.h)

Library

Ks.lib

 

 

Send comments about this topic to Microsoft

Show: