FLT_PARAMETERS pour union IRP_MJ_NETWORK_QUERY_OPEN

Article
02/27/2024

Le composant d'union suivant est utilisé lorsque le champ MajorFunction de la structure FLT_IO_PARAMETER_BLOCK pour l’opération est IRP_MJ_NETWORK_QUERY_OPEN.

Syntaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIRP                           Irp;
    PFILE_NETWORK_OPEN_INFORMATION NetworkInformation;
  } NetworkQueryOpen;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membres

NetworkQueryOpen : Structure contenant les membres suivants.
Irp : pointeur vers une IRP de création qui représente cette opération d'ouverture. Cette IRP doit être utilisée par le système de fichiers pour le code commun d'ouverture/création, mais elle n'est pas achevée.
NetworkInformation : Pointeur vers un tampon structuré FILE_NETWORK_OPEN_INFORMATION destiné à recevoir les informations demandées sur le fichier.

Notes

La structure FLT_PARAMETERS pour les opérations IRP_MJ_NETWORK_QUERY_OPEN contient les paramètres d'une opération NetworkQueryOpen représentée par une structure (FLT_CALLBACK_DATA). La structure FLT_PARAMETERS est contenue dans une structure FLT_IO_PARAMETER_BLOCK.

Remarque

L'objet fichier associé à IRP_MJ_NETWORK_QUERY_OPEN est un objet de type pile. Un filtre enregistré pour le rappel NetworkQueryOpen ne doit pas référencer cet objet. En d'autres termes, n'appelez pas ObReferenceObject ou ObDereferenceObject sur cet objet de fichier basé sur la pile, et n'enregistrez pas de pointeur sur l'objet.

IRP_MJ_NETWORK_QUERY_OPEN est une opération d'E/S rapide. C'est l'équivalent de l'opération FastIoQueryOpen (pas FastIoQueryNetworkOpenInfo). Un filtre peut rejeter l'opération dans son rappel avant opération en utilisant FLT_PREOP_DISALLOW_FASTIO. Il ne peut pas rejeter l'opération dans son rappel après opération puisque le système de fichiers a déjà terminé l'opération et que les données sont présentes.