FLT_PARAMETERS pour IRP_MJ_LOCK_CONTROL union

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

Syntaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PLARGE_INTEGER          Length;
    ULONG POINTER_ALIGNMENT Key;
    LARGE_INTEGER           ByteOffset;
    PEPROCESS               ProcessId;
    BOOLEAN                 FailImmediately;
    BOOLEAN                 ExclusiveLock;
  } LockControl;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membres

  • LockControl : structure contenant les membres suivants.

  • Longueur : pointeur vers une variable qui spécifie la longueur en octets de la plage à verrouiller.

  • Clé : valeur de clé à affecter au verrou de plage d’octets.

  • ByteOffset : décalage d’octet de démarrage dans le fichier de la plage à verrouiller.

  • ProcessId : pointeur opaque vers l’objet de processus pour le processus qui a demandé le verrou de plage d’octets.

  • Échec immédiat : valeur booléenne spécifiant si la demande de verrouillage doit échouer si le verrou ne peut pas être accordé immédiatement. Ce membre a la valeur FALSE si le thread demandeur peut être placé dans un état d’attente jusqu’à ce que la demande soit accordée ou TRUE s’il ne peut pas.

  • ExclusiveLock : valeur booléenne spécifiant si un verrou exclusif est demandé. Ce membre a la valeur TRUE si un verrou exclusif est demandé ou FALSE si un verrou partagé est demandé.

Remarques

Structure FLT_PARAMETERS pour l’opération de IRP_MJ_LOCK_CONTROL 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_LOCK_CONTROL peut être une opération d’E/S basée sur IRP ou une opération d’E/S rapide.

Configuration requise

Type d’exigence Condition requise
En-tête Fltkernel.h (inclure Fltkernel.h)

Voir aussi

ACCESS_MASK

ACCESS_STATE

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_IS_FASTIO_OPERATION

FLT_IS_FS_FILTER_OPERATION

FLT_IS_IRP_OPERATION

FLT_PARAMETERS

FltAllocateFileLock

FltCheckLockForReadAccess

FltCheckLockForWriteAccess

FltFreeFileLock

FltInitializeFileLock

FltProcessFileLock

FltUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE

PUNLOCK_ROUTINE