FltVetoBypassIo-Funktion (fltkernel.h)

Artikel
02/29/2024

FltVetoBypassIo ruft Informationen ab, die zum Veto einer BypassIO-Anforderung erforderlich sind.

Syntax

NTSTATUS FLTAPI FltVetoBypassIo(
  [in] PFLT_CALLBACK_DATA    CallbackData,
  [in] PCFLT_RELATED_OBJECTS FltObjects,
  [in] NTSTATUS              OperationStatus,
  [in] PCUNICODE_STRING      FailureReason
);

Parameter

[in] CallbackData

Zeiger auf den FLT_CALLBACK_DATA für FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Zeiger auf die FLT_RELATED_OBJECTS-Struktur für den BypassIO-Vorgang.

[in] OperationStatus

Der vom Filter für das Veto bereitgestellte NTSTATUS-Fehlercode.

[in] FailureReason

Eine eindeutige, beschreibende Zeichenfolge, die Details dazu enthält, warum der Filter ein Veto gegen die BypassIO-Aktivierungsanforderung ein Veto eingeht.

Rückgabewert

FltVetoBypassIo gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Andernfalls wird ein NTSTATUS-Wert wie einer der folgenden zurückgegeben.

Wert	Bedeutung
STATUS_BUFFER_TOO_SMALL	Der Ausgabepuffer des FSCTL ist zu klein.
STATUS_INVALID_BUFFER_SIZE	Der Eingabepuffer des FSCTL ist zu klein.
STATUS_INVALID_PARAMETER_3	Ein entsprechender Fehlercode wurde nicht bereitgestellt.
STATUS_INVALID_PARAMETER_4	Ein angemessener Fehlergrund wurde nicht angegeben.
STATUS_NOT_SUPPORTED	Der angeforderte Vorgang wird nicht unterstützt oder von einem Pre-Op-Rückruf nicht angefordert.

Hinweise

Ein Minifilter ruft FltVetoBypassIo auf, wenn er ein Veto gegen eine FS_BPIO_OP_ENABLE oder FS_BPIO_OP_QUERY Anforderung für eine Datei einlegen möchte. Ein Minifilter sollte diese Routine nur über den Rückruf vor dem Vorgang aufrufen.

FltVetoBypassIo füllt die vom Aufrufer zugewiesene FS_BPIO_OUTPUT Struktur, die CallbackData zugeordnet ist, mit den Informationen aus, die für das Veto gegen die BypassIO-Anforderung erforderlich sind. Der Aufrufer muss einen Puffer bereitstellen, der groß genug ist, um die Struktur aufzunehmen.

FltVetoBypassIo protokolliert ein ETW-Ereignis mit dem status, dem vom Filter bereitgestellten Grund und dem Namen des Filters.

Weitere Informationen finden Sie unter BypassIO für Filtertreiber und Unterstützen von BypassIO-Vorgängen .