Fonction FltVetoBypassIo (fltkernel.h)

Article
12/05/2023

FltVetoBypassIo récupère les informations nécessaires pour opposer son veto à une demande BypassIO.

Syntaxe

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

Paramètres

[in] CallbackData

Pointeur vers le FLT_CALLBACK_DATA pour FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Pointeur vers la structure FLT_RELATED_OBJECTS pour l’opération BypassIO.

[in] OperationStatus

Code d’erreur NTSTATUS fourni par le filtre pour le veto.

[in] FailureReason

Chaîne descriptive unique qui fournit des détails sur la raison pour laquelle le filtre oppose son veto à la demande d’activation BypassIO.

Valeur retournée

FltVetoBypassIo retourne STATUS_SUCCESS en cas de réussite de l’exécution ; sinon, elle retourne une valeur NTSTATUS telle que l’une des valeurs suivantes.

Valeur	Signification
STATUS_BUFFER_TOO_SMALL	La mémoire tampon de sortie du FSCTL est trop petite.
STATUS_INVALID_BUFFER_SIZE	La mémoire tampon d’entrée du FSCTL est trop petite.
STATUS_INVALID_PARAMETER_3	Aucun code d’erreur approprié n’a été fourni.
STATUS_INVALID_PARAMETER_4	Aucune raison d’échec appropriée n’a été fournie.
STATUS_NOT_SUPPORTED	L’opération demandée n’est pas prise en charge ou n’a pas été demandée à partir d’un rappel pré-op.

Remarques

Un minifiltre appelle FltVetoBypassIo lorsqu’il a l’intention d’opposer son veto à une FS_BPIO_OP_ENABLE ou FS_BPIO_OP_QUERY demande sur un fichier. Un minifiltre ne doit appeler cette routine qu’à partir de son rappel de pré-opération.

FltVetoBypassIo remplit la structure de FS_BPIO_OUTPUT allouée à l’appelant associée à CallbackData avec les informations nécessaires pour opposer son veto à la requête BypassIO. L’appelant doit fournir une mémoire tampon suffisamment grande pour contenir la structure.

FltVetoBypassIo journalise un événement ETW avec le status, la raison fournie par le filtre et le nom du filtre.

Pour plus d’informations, consultez BypassIO pour les pilotes de filtre et Prise en charge des opérations BypassIO .