Code de contrôle FSCTL_REQUEST_OPLOCK_LEVEL_2

Article
09/22/2022
2 minutes de lecture

Le code de contrôle FSCTL_REQUEST_OPLOCK_LEVEL_2 demande un verrou opportuniste de niveau 2 (OPLOCK) sur un fichier.

Pour traiter ce code de contrôle, un minifiltre appelle FltOplockFsctrl avec les paramètres suivants. Un système de fichiers ou un pilote de filtre hérité appelle FsRtlOplockFsctrl.

pour plus d’informations sur le verrouillage opportuniste et sur le code de contrôle de FSCTL_REQUEST_OPLOCK_LEVEL_2 , consultez la documentation Microsoft Windows SDK.

Paramètres

Verrou
Pointeur d’objet oplock opaque pour le fichier.

CallbackData
FltOplockFsctrl uniquement. Structure de données de rappel (FLT_CALLBACK_DATA) pour une demande IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. Le paramètre FsControlCode de l’opération doit être FSCTL_REQUEST_OPLOCK_LEVEL_2.

Paquets
FsRtlOplockFsctrl uniquement. IRP pour une demande IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. Le paramètre FsControlCode de l’opération doit être FSCTL_REQUEST_OPLOCK_LEVEL_2.

OpenCount
Spécifie l’état de verrouillage du fichier. Affectez à ce paramètre une valeur ULONG différente de zéro s’il existe des verrous de plage d’octets sur le fichier, ou zéro dans le cas contraire.

Bloc d’état

FltOplockFsctrl retourne FLT_PREOP_PENDING pour cette opération si le oplock a été accordé. Sinon, elle retourne FLT_PREOP_COMPLETE.

FsRtlOplockFsctrl retourne l’une des valeurs NTSTATUS suivantes pour cette opération :

Terme	Description
STATUS_PENDING	Le oplock a été accordé. Il s’agit d’un code de réussite.
STATUS_CANCELLED	L’IRP a été annulée avant la fin de l’opération de FSCTL_REQUEST_OPLOCK_LEVEL_2. Il s’agit d’un code d’erreur.
STATUS_OPLOCK_NOT_GRANTED	Le oplock n’a pas pu être accordé. Il s’agit d’un code d’erreur.