Partager via


FltIsIoRedirectionAllowed, fonction (fltkernel.h)

La routine FltIsIoRedirectionAllowed détermine si les E/S peuvent être redirigées de l’instance de filtre source spécifiée vers une autre instance de filtre spécifiée.

Syntaxe

NTSTATUS FLTAPI FltIsIoRedirectionAllowed(
  [in]  PFLT_INSTANCE SourceInstance,
  [in]  PFLT_INSTANCE TargetInstance,
  [out] PBOOLEAN      RedirectionAllowed
);

Paramètres

[in] SourceInstance

Instance de filtre sur la pile d’appareils source.

[in] TargetInstance

Instance de filtre sur la pile d’appareils cible.

[out] RedirectionAllowed

Valeur de TRUE si toutes les E/S vers la pile d’appareils source peuvent être redirigées vers la pile d’appareils cible en modifiant l’instance de filtre référencée, sinon FALSE.

Valeur de retour

Valeur NTSTATUS de STATUS_SUCCESS de réussite ou de STATUS_NOT_SUPPORTED si la redirection n’est pas prise en charge.

Remarques

Une opération d’E/S est associée à une structure FLT_CALLBACK_DATA. Cette structure contient une référence à un objet PFLT_IO_PARAMETER_BLOCK, qui contient une référence à l’FLT_INSTANCE du minifilter associé à l’opération d’E/S.

Si RedirectionAllowed est TRUE, le minifilter peut rediriger les E/S en modifiant cette instance vers une nouvelle instance cible.

Si RedirectionAllowed est FALSE, le minifilter doit allouer un nouvel objet de données de rappel pour émettre des E/S sur la pile cible ou appeler FltAdjustDeviceStackSizeForIoRedirection pour augmenter la taille de la pile d’appareils source.

Remarque mini-filtres ne doivent pas modifier la référence au FLT_INSTANCE avant de vérifier que la redirection peut être effectuée de cette façon. Utilisez FltIsIoRedirectionAllowedForOperation ou FltIsIoRedirectionAllowed.
 

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows.
plateforme cible Universel
d’en-tête fltkernel.h (include FltKernel.h)
bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <=DISPATCH_LEVEL

Voir aussi

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowedForOperation