PUNLOCK_ROUTINE fonction de rappel (ntifs.h)

Article
02/29/2024

Un filtre (filtre hérité ou minifiltre) peut inscrire une routine de type PUNLOCK_ROUTINE en tant que routine de rappel UnlockRoutine du filtre pour une structure FILE_LOCK .

Syntaxe

PUNLOCK_ROUTINE PunlockRoutine;

void PunlockRoutine(
  PVOID Context,
  PFILE_LOCK_INFO FileLockInfo
)
{...}

Paramètres

Context

[in] Pointeur de contexte passé à FltProcessFileLock ou FsRtlProcessFileLock.

FileLockInfo

Pointeur opaque vers la structure FILE_LOCK_INFO pour le verrou de plage d’octets.

Valeur de retour

None

Remarques

Un filtre (filtre hérité ou minifiltre) peut éventuellement spécifier une routine de type PUNLOCK_ROUTINE comme rappel UnlockRoutine du filtre pour un verrou de fichier de plage d’octets.

Si le filtre spécifie une routine UnlockRoutine pour une structure FILE_LOCK, cette routine est appelée lorsque le verrou est supprimé d’une plage d’octets verrouillée dans un fichier.

Un minifilter spécifie cette routine en passant un pointeur vers la routine en tant que paramètre UnlockRoutine pour FltAllocateFileLock.

Un filtre hérité spécifie cette routine en passant un pointeur vers la routine en tant que paramètre UnlockRoutine pour FsRtlAllocateFileLock ou FsRtlInitializeFileLock.