Fonction FltIsIoRedirectionAllowed (fltkernel.h)

  • Article

La routine FltIsIoRedirectionAllowed détermine si les E/S peuvent être redirigées à partir du filtre source spécifié instance vers un autre filtre spécifié instance.

Syntaxe

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

Paramètres

[in] SourceInstance

Le filtre instance sur la pile d’appareils source.

[in] TargetInstance

Le filtre instance sur la pile d’appareils cible.

[out] RedirectionAllowed

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

Valeur retournée

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 à la FLT_INSTANCE du minifiltre associé à l’opération d’E/S.

Si RedirectionAllowed a la valeur TRUE, le minifiltre peut rediriger les E/S en remplaçant cette instance par une nouvelle instance cible.

Si RedirectionAllowed a la valeur FALSE, le minifiltre 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.

Note Les minifiltres 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.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows.
Plateforme cible Universal
En-tête fltkernel.h (incluez FltKernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <=DISPATCH_LEVEL

Voir aussi

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowedForOperation