PUNLOCK_ROUTINE função de retorno de chamada (ntifs.h)

Artigo
04/23/2024

Um filtro (filtro herdado ou minifiltro) pode registrar uma rotina de tipo PUNLOCK_ROUTINE como a rotina de retorno de chamada UnlockRoutine do filtro para uma estrutura FILE_LOCK .

Sintaxe

PUNLOCK_ROUTINE PunlockRoutine;

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

Parâmetros

Context

[in] Ponteiro de contexto que foi passado para FltProcessFileLock ou FsRtlProcessFileLock.

FileLockInfo

Ponteiro opaco para a estrutura FILE_LOCK_INFO para o bloqueio de intervalo de bytes.

Retornar valor

Nenhum

Comentários

Um filtro (filtro herdado ou minifiltro) pode, opcionalmente, especificar uma rotina de tipo PUNLOCK_ROUTINE como o retorno de chamada UnlockRoutine do filtro para um bloqueio de arquivo de intervalo de bytes.

Se o filtro especificar uma rotina UnlockRoutine para uma estrutura FILE_LOCK, essa rotina será chamada quando o bloqueio for removido de um intervalo de bytes bloqueado em um arquivo.

Um minifiltro especifica essa rotina passando um ponteiro para a rotina como o parâmetro UnlockRoutine para FltAllocateFileLock.

Um filtro herdado especifica essa rotina passando um ponteiro para a rotina como o parâmetro UnlockRoutine para FsRtlAllocateFileLock ou FsRtlInitializeFileLock.