Freigeben über


KsFastMethodHandler-Funktion (ks.h)

Die KsFastMethodHandler Funktion verarbeitet schnelle Methoden, die über IOCTL_KS_METHOD angefordert werden. Sie antwortet auf alle Methodenbezeichner, die durch die Sätze definiert werden, die auch in der liste "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 gestellt 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 vom Aufrufer des Methodenparameters 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.

[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 behandelt wird. Wenn die Anforderung nicht verarbeitet wird, wird ein IRP generiert. Wenn die Anforderung behandelt 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 IoStatus->Status-Feld fest, wenn die Methode behandelt wird.

Bemerkungen

Der Besitzer eines Methodensatzes kann die Vorfilterung oder Nachfilterung der Methodenbehandlung mithilfe der KsFastMethodHandler- und KsMethodHandler--Funktionen ausführen. Die KsFastMethodHandler--Funktion wird verwendet, um Anforderungen zu verarbeiten, die über die schnelle E/A-Verteilerschnittstelle für die Gerätesteuerung vorgenommen werden. Es wird nur verwendet, um Anforderungen zu verarbeiten, die schnell erfüllt werden können. Der parameter Wait der schnellen E/A-Funktion wird nicht übergeben und angenommen, dass er TRUEist.

Anforderungen

Anforderung Wert
Zielplattform- Universal
Header- ks.h (enthalten Ks.h)
Library Ks.lib

Siehe auch

KsMethodHandler-