KsMethodHandler-Funktion (ks.h)
Die KsMethodHandler-Funktion verarbeitet Methoden, die über IOCTL_KS_METHOD angefordert werden. Es funktioniert mit allen Methodenbezeichnern, die von den Sätzen definiert werden. Die Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.
Syntax
KSDDKAPI NTSTATUS KsMethodHandler(
[in] PIRP Irp,
[in] ULONG MethodSetsCount,
[in] const KSMETHOD_SET *MethodSet
);
Parameter
[in] Irp
Gibt das IRP mit der zu verarbeitenden Methodenanforderung an.
[in] MethodSetsCount
Gibt die Anzahl der übergebenen Methodensatzstrukturen an.
[in] MethodSet
Gibt den Zeiger auf die Liste der Methodensatzinformationen an.
Rückgabewert
Die KsMethodHandler-Funktion gibt bei erfolgreicher Ausführung STATUS_SUCCESS oder einen fehlerspezifischen Fehler für die zu behandelnde Methode zurück, wenn sie nicht erfolgreich ist. Die Funktion legt immer die IO_STATUS_BLOCK fest. Informationsfeld des PIRP. IoStatus-Element innerhalb des IRP aufgrund eines internen Fehlers auf null festgelegt, es sei denn, das Element wird von einem Methodenhandler festgelegt. Die Funktion legt die IO_STATUS_BLOCK nicht fest. Statusfeld, oder vervollständigen Sie die IRP.
Hinweise
Der Besitzer eines Methodensatzes kann mithilfe der Funktionen KsMethodHandler und KsFastMethodHandler eine Vor- oder Nachfilterung der Methodenbehandlung durchführen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |