KsMethodHandler-Funktion (ks.h)

  • Artikel

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

Weitere Informationen

KsFastMethodHandler

KsMethodHandlerWithAllocator