FltVetoBypassIo, fonction (fltkernel.h)

Article
02/06/2025

FltVetoBypassIo récupère les informations nécessaires pour opposer un 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 la 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 unique et descriptive qui fournit des détails sur la raison pour laquelle le filtre met un veto à la demande d’activation BypassIO.

Valeur de retour

FltVetoBypassIo retourne STATUS_SUCCESS à l’achèvement réussi ; sinon, elle retourne une valeur NTSTATUS telle que l’une des 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	Un code d’erreur approprié n’a pas été fourni.
STATUS_INVALID_PARAMETER_4	Une raison d’échec appropriée n’a pas é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 minifilter appelle FltVetoBypassIo lorsqu’il a l’intention de veto sur un FS_BPIO_OP_ENABLE ou une demande de FS_BPIO_OP_QUERY sur un fichier. Un minifilter ne doit appeler cette routine qu’à partir de son rappel de pré-opération.

FltVetoBypassIo remplit la structure FS_BPIO_OUTPUT allouée par l’appelant associé à CallbackData avec les informations nécessaires pour refuser la demande BypassIO. L’appelant doit fournir une mémoire tampon suffisamment grande pour contenir la structure.

FltVetoBypassIo journalise un événement ETW avec l’état, 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.