Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |