FLT_PARAMETERS pour union IRP_MJ_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_QUERY_OPEN.

Syntaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIRP                   Irp;
    PVOID                  FileInformation;
    PULONG                 Length;
    FILE_INFORMATION_CLASS FileInformationClass;
  } QueryOpen;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membres

Irp : pointeur vers l’IRP associé à cette opération.
FileInformation : pointeur vers une mémoire tampon allouée par l’appelant dans laquelle la routine écrit les informations demandées sur l’objet de fichier. Le membre FileInformationClass spécifie le type d’informations que l’appelant demande.
Longueur : pointeur vers la taille, en octets, de la mémoire tampon pointée par FileInformation.

FileInformationClass : spécifie le type d’informations à renvoyer sur le fichier, dans la mémoire tampon vers laquelle FileInformation pointe. Les pilotes de périphérique et intermédiaires peuvent spécifier l’une des valeurs de FILE_INFORMATION_CLASS suivantes. D’autres valeurs provoquent l’échec de l’appel et ne doivent pas être passées aux appels PreQueryOpen/PostQueryOpen.

Valeur FILE_INFORMATION_CLASS	Type d'informations retournées
FileStatInformation	Structure FILE_STAT_INFORMATION. Cette structure contient un masque d’accès. Pour plus d’informations sur les masques d'accès, consultez ACCESS_MASK.
FileStatLxInformation	Structure FILE_STAT_LX_INFORMATION. Cette structure contient un masque d’accès. Pour plus d’informations sur les masques d'accès, consultez ACCESS_MASK.
FileCaseSensitiveInformation	Structure FILE_CASE_SENSITIVE_INFORMATION.
FileStatBasicInformation	Structure FILE_STAT_BASIC_INFORMATION.

Notes

La structure FLT_PARAMETERS pour les opérations de IRP_MJ_QUERY_OPEN contient les paramètres d’une opération QueryOpen représentée par une structure de données de rappel (FLT_CALLBACK_DATA). Elle est contenue dans une structure FLT_IO_PARAMETER_BLOCK.

IRP_MJ_QUERY_OPEN est une opération de rappel de système de fichiers (FSFilter). Un filtre peut rejeter l'opération à la fois dans son rappel avant opération et dans son rappel après opération en utilisant FLT_PREOP_DISALLOW_FSFILTER_IO et FLT_POSTOP_DISALLOW_FSFILTER_IO, respectivement.

Le système de fichiers ne renseigne pas le champ Informations dans le bloc IO_STATUS. Les filtres ne doivent pas inspecter cette valeur dans leurs post-appels.

Pour plus d’informations sur les opérations de rappel FSFilter, consultez l’entrée de référence pour FsRtlRegisterFileSystemFilterCallbacks.