PFNKSFASTHANDLER-Rückruffunktion (ks.h)

Artikel
02/26/2024

KStrFastHandler ist eine vom Treiber bereitgestellte Routine, die eine Eigenschafts- oder Methodenanforderung ohne erstellung eines IRP verarbeitet.

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, für das die Anforderung durchgeführt wurde.

[in] Request

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

[in] RequestLength

Gibt die Länge an, die vom Aufrufer des Eigenschaftsparameters angegeben wird.

[in, out] Data

Gibt den ursprünglichen nicht ausgerichteten Datenparameter an.

[in] DataLength

Gibt die Länge an, die vom Aufrufer des data-Parameters angegeben wird.

[out] IoStatus

Gibt eine ausgerichtete Struktur an, die verwendet wird, um Fehler status und Informationen zurückzugeben. Diese Informationen werden dann nach Abschluss in die ursprüngliche E/A-status-Struktur kopiert.

Rückgabewert

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

Hinweise

Der Minitreiber stellt einen Einstiegspunkt für diese Routine in KSFASTPROPERTY_ITEM oder KSFASTMETHOD_ITEM bereit.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	ks.h (ks.h einschließen)

Freigeben über