KsFastMethodHandler-Funktion (ks.h)

Artikel
02/26/2024

Die KsFastMethodHandler-Funktion verarbeitet schnelle Methoden, die über IOCTL_KS_METHOD angefordert werden. Sie antwortet auf alle Methodenbezeichner, die von den Sätzen definiert werden, die ebenfalls in der Liste für schnelle E/A enthalten sind. Diese Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.

Syntax

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

Parameter

[in] FileObject

Gibt das Dateiobjekt an, für das die Anforderung durchgeführt wurde.

[in] Method

Gibt den ursprünglichen Methodenparameter an. Dies wird immer auf FILE_LONG_ALIGNMENT, aber möglicherweise nicht auf FILE_QUAD_ALIGNMENT.

[in] MethodLength

Gibt die Länge an, die vom Aufrufer des Methodenparameters 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.

[in] MethodSetsCount

Gibt die Anzahl der übergebenen Methodensatzstrukturen an.

[in] MethodSet

Gibt den Zeiger auf die Liste der Methodensatzinformationen an.

Rückgabewert

Die KsFastMethodHandler-Funktion gibt TRUE zurück, wenn die Anforderung behandelt wird, oder FALSE , wenn die Anforderung nicht verarbeitet wird. Wenn die Anforderung nicht verarbeitet wird, wird ein IRP generiert. Wenn die Anforderung verarbeitet wurde, legt die Funktion das IoStatus-Information-Element> aufgrund eines internen Fehlers auf Null fest, oder das Element wird von einem Methodenhandler festgelegt. Der Methodenhandler legt auch das Feld IoStatus-Status> fest, wenn die Methode behandelt wird.

Hinweise

Der Besitzer eines Methodensatzes kann mithilfe der Funktionen KsFastMethodHandler und KsMethodHandler eine Vor- oder Nachfilterung der Methodenbehandlung durchführen. Die KsFastMethodHandler-Funktion wird verwendet, um Anforderungen zu verarbeiten, die über die schnelle E/A-Verteilerschnittstelle für die Gerätesteuerung gesendet werden. Es wird nur verwendet, um Anforderungen zu verarbeiten, die schnell erfüllt werden können. Der Wait-Parameter der schnellen E/A-Funktion wird nicht übergeben und als TRUE angenommen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ks.h (ks.h einschließen)
Bibliothek	Ks.lib

Weitere Informationen

KsMethodHandler

Freigeben über