Funzione FltVetoBypassIo (fltkernel.h)

Articolo
02/26/2024

FltVetoBypassIo recupera le informazioni necessarie per veto 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 univoca e descrittiva che fornisce dettagli sul motivo per cui il filtro sta vetando la richiesta di abilitazione BypassIO.

Valore restituito

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

Valore	Significato
STATUS_BUFFER_TOO_SMALL	Il buffer di output DI FSCTL è troppo piccolo.
STATUS_INVALID_BUFFER_SIZE	Il 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 fornito un motivo di errore appropriato.
STATUS_NOT_SUPPORTED	L'operazione richiesta non è supportata o non è stata richiesta da un callback pre-op.

Commenti

Un minifilter chiama FltVetoBypassIo quando intende veto un FS_BPIO_OP_ENABLE o FS_BPIO_OP_QUERY richiesta in un file. Un minifilter deve chiamare questa routine solo dal callback di pre-operazione.

FltVetoBypassIo riempie la struttura di FS_BPIO_OUTPUT allocata dal chiamante associata a CallbackData con le informazioni necessarie per veto della richiesta BypassIO. Il chiamante deve fornire un buffer sufficiente per contenere la struttura.

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

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