FLT_PARAMETERS pour l’union IRP_MJ_MDL_READ

Article
06/13/2024

Le membre de l’union FLT_PARAMETERS suivant est utilisé lorsque FLT_IO_PARAMETER_BLOCK.MajorFunction est IRP_MJ_MDL_READ.

Syntaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    LARGE_INTEGER           FileOffset;
    ULONG POINTER_ALIGNMENT Length;
    ULONG POINTER_ALIGNMENT Key;
    PMDL                    *MdlChain;
  } MdlRead;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membres

MdlRead : Structure contenant les membres suivants.
FileOffset : Octet de départ dans le fichier mis en cache.
Length : Longueur, en octets, des données à lire à partir du fichier mis en cache.
Key : Valeur clé associée à un verrou de plage d’octets sur le fichier cible. Si la plage à lire chevauche ou est une sous-plage d’une plage verrouillée exclusivement dans le fichier, ce paramètre doit être la clé de ce verrou exclusif. Le verrou exclusif doit être détenu par le processus parent du thread appelant ; sinon, ce paramètre est ignoré.
MdlChain : Pointeur vers une variable qui reçoit un pointeur vers une chaîne d’une ou plusieurs listes de descripteurs de mémoire (MDL) qui décrivent les pages contenant les données à lire.

Notes

IRP_MJ_MDL_READ est une opération d’E/S rapide. Elle fait la même chose que IRP_MJ_READ + IRP_MN_MDL à l’exception de la différence suivante :

L’opération basée sur IRP configure la mise en cache sur le fichier si celui-ci n’est pas déjà mis en cache avant de faire le travail MDL.
L’opération Fast IO (opération d'E/S rapide ) échoue si le fichier n’est pas déjà mis en cache.

La structure FLT_PARAMETERS pour les opérations IRP_MJ_MDL_READ contient les paramètres pour une opération rapide d’E/S MdlRead. L’opération est représentée par une structure (FLT_CALLBACK_DATA), avec les paramètres de l’opération dans la structure FLT_IO_PARAMETER_BLOCK à laquelle Iopb pointe.

Si une demande rapide d’E/S IRP_MJ_MDL_READ échoue, l’émetteur de l’E/S détermine comment réémettre la demande. Par exemple, la demande peut être rééditée en tant qu’opération basée sur IRP à l’aide de IRP_MJ_READ + IRP_MN_MDL.