PFNKSFASTHANDLER callback function (ks.h)

Article
02/22/2024

KStrFastHandler is a driver-supplied routine that handles a property or method request without the creation of an IRP.

Syntax

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Parameters

[in] FileObject

Specifies the file object on which the request was made.

[in] Request

Specifies the original property parameter. This will always be on FILE_LONG_ALIGNMENT, but cannot be on FILE_QUAD_ALIGNMENT.

[in] RequestLength

Specifies the length indicated by the caller of the property parameter.

[in, out] Data

Specifies the original unaligned data parameter.

[in] DataLength

Specifies the length indicated by the caller of the data parameter.

[out] IoStatus

Specifies an aligned structure that is used to return error status and information. This information is then copied to the original I/O status structure on completion.

Return value

KStrFastHandler returns TRUE if the call was handled. If the call was not handled, it returns FALSE and an IRP is generated to handle the request.

Remarks

The minidriver provides an entry point for this routine in KSFASTPROPERTY_ITEM or KSFASTMETHOD_ITEM.

Requirements

Requirement	Value
Target Platform	Desktop
Header	ks.h (include Ks.h)

Share via