PFNKSFASTHANDLER-Rückruffunktion (ks.h)

KStrFastHandler ist eine vom Treiber bereitgestellte Routine, die eine Eigenschafts- oder Methodenanforderung ohne Die 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 gestellt 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 vom Aufrufer des Eigenschaftsparameters angegebene Länge an.

[in, out] Data

Gibt den ursprünglichen nicht ausgerichteten Datenparameter an.

[in] DataLength

Gibt die vom Aufrufer des Datenparameters angegebene Länge an.

[out] IoStatus

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

Rückgabewert

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

Bemerkungen

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	ks.h (enthalten Ks.h)