PFNKSFASTHANDLER-Rückruffunktion (ks.h)

KStrFastHandler ist eine vom Treiber bereitgestellte Routine, die eine Eigenschafts- oder Methodenanforderung behandelt, ohne dass ein IRP erstellt wird.

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
)
{...}

Parameter

[in] FileObject

Gibt das Dateiobjekt an, auf dem die Anforderung vorgenommen wurde.

[in] Request

Gibt den ursprünglichen Eigenschaftenparameter an. Dies wird immer FILE_LONG_ALIGNMENT sein, kann aber nicht auf FILE_QUAD_ALIGNMENT sein.

[in] RequestLength

Gibt die durch den Aufrufer des Eigenschaftsparameters angegebene Länge an.

[in, out] Data

Gibt den ursprünglichen nicht ausgerichteten Datenparameter an.

[in] DataLength

Gibt die durch den Aufrufer des Datenparameters angegebene Länge an.

[out] IoStatus

Gibt eine ausgerichtete Struktur an, die zum Zurückgeben des Fehlerstatus und der Informationen verwendet wird. Diese Informationen werden dann in die ursprüngliche I/O-Statusstruktur nach Abschluss kopiert.

Rückgabewert

KStrFastHandler gibt TRUE zurück, wenn der Aufruf behandelt wurde. Wenn der Aufruf nicht behandelt wurde, wird FALSE zurückgegeben, und ein IRP wird generiert, um die Anforderung zu behandeln.

Bemerkungen

Der Minidriver bietet einen Einstiegspunkt für diese Routine in KSFASTPROPERTY_ITEM oder KSFASTMETHOD_ITEM.

Anforderungen

   
Zielplattform Power BI Desktop
Header ks.h (einschließlich Ks.h)