FLT_PARAMETERS pour IRP_MJ_CREATE union

Article
03/14/2023

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

Syntaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT FileAttributes;
    USHORT                   ShareAccess;
    USHORT POINTER_ALIGNMENT EaLength;
    PVOID                    EaBuffer;
    LARGE_INTEGER            AllocationSize;
  } Create;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membres

La structure Créer de FLT_PARAMETERS contient les membres suivants.

SecurityContext : pointeur vers une structure IO_SECURITY_CONTEXT qui représente le contexte de sécurité d’une demande de IRP_MJ_CREATE, où :

SecurityContext->AccessState est un pointeur vers une structure ACCESS_STATE qui contient le contexte d’objet de l’objet, les types d’accès accordés et les types d’accès souhaités restants.
SecurityContext->DesiredAccess est une structure ACCESS_MASK qui spécifie les droits d’accès demandés pour le fichier. Pour plus d’informations, consultez le paramètre DesiredAccess sur FltCreateFile.
Options : masque de bits d’indicateurs qui spécifient les options à appliquer lors de la création ou de l’ouverture du fichier, ainsi que l’action à entreprendre si le fichier existe déjà. Les 24 bits de ce membre correspondent au paramètre CreateOptions à FltCreateFile. Les 8 bits élevés correspondent au paramètre CreateDisposition à FltCreateFile.
FileAttributes : masque de bits des attributs à appliquer lors de la création ou de l’ouverture du fichier. Pour plus d’informations, consultez le paramètre FileAttributes sur FltCreateFile.
ShareAccess : masque de bits des droits d’accès au partage demandés pour le fichier. Si ce paramètre est égal à zéro, l’accès exclusif est demandé. Pour plus d’informations, consultez le paramètre ShareAccess sur FltCreateFile.
EaLength : longueur, en octets, de la mémoire tampon vers laquelle pointe le membre EaBuffer . Pour plus d’informations, consultez le paramètre EaLength sur FltCreateFile.
EaBuffer : pointeur vers une mémoire tampon structurée FILE_FULL_EA_INFORMATION fournie par l’appelant qui contient des informations d’attribut étendu (EA) à appliquer au fichier. Pour plus d’informations, consultez le paramètre EaBuffer pour FltCreateFile.
AllocationSize : spécifie éventuellement la taille d’allocation initiale, en octets, pour le fichier. Une valeur différente de zéro n’a aucun effet, sauf si le fichier est en cours de création, de remplacement ou de remplacement. Pour plus d’informations, consultez le paramètre AllocationSize to FltCreateFile.

Remarques

La structure FLT_PARAMETERS de l’opération de IRP_MJ_CREATE contient les paramètres d’une opération Create basée sur IRP représentée par une structure de données de rappel (FLT_CALLBACK_DATA). Il est contenu dans une structure FLT_IO_PARAMETER_BLOCK .

IRP_MJ_CREATE est une opération basée sur IRP.