Funzione FltVetoBypassIo (fltkernel.h)

Articolo
02/06/2025

FltVetoBypassIo recupera le informazioni necessarie per veto a una richiesta BypassIO.

Sintassi

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

Parametri

[in] CallbackData

Puntatore al FLT_CALLBACK_DATA per FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Puntatore alla struttura FLT_RELATED_OBJECTS per l'operazione BypassIO.

[in] OperationStatus

Codice di errore NTSTATUS fornito dal filtro per il veto.

[in] FailureReason

Stringa descrittiva univoca che fornisce informazioni dettagliate sul motivo per cui il filtro sta vetando la richiesta di abilitazione BypassIO.

Valore restituito

FltVetoBypassIo restituisce STATUS_SUCCESS al completamento; in caso contrario, restituisce un valore NTSTATUS, ad esempio uno dei seguenti.

Valore	Significato
STATUS_BUFFER_TOO_SMALL	Il buffer di output di OUTPUT di FSCTL è troppo piccolo.
STATUS_INVALID_BUFFER_SIZE	L'buffer di input DI FSCTL è troppo piccolo.
STATUS_INVALID_PARAMETER_3	Non è stato fornito un codice di errore appropriato.
STATUS_INVALID_PARAMETER_4	Non è stato specificato un motivo di errore appropriato.
STATUS_NOT_SUPPORTED	L'operazione richiesta non è supportata o non è stata richiesta da un callback pre-operativo.

Osservazioni

Un minifiltro chiama FltVetoBypassIo quando intende veto un FS_BPIO_OP_ENABLE o FS_BPIO_OP_QUERY richiesta su un file. Un minifiltro deve chiamare questa routine solo dal callback precedente all'operazione.

FltVetoBypassIo compila la struttura FS_BPIO_OUTPUT allocata dal chiamante associata a CallbackData con le informazioni necessarie per impostare la richiesta BypassIO. Il chiamante deve fornire un buffer sufficientemente grande da contenere la struttura.

FltVetoBypassIo registra un evento ETW con lo stato, il motivo specificato dal filtro e il nome del filtro.

Per altre informazioni, vedere BypassIO per i driver di filtro e supporto delle operazioni BypassIO.