Função FsRtlAllocateFileLock (ntifs.h)

Artigo
02/26/2024

A rotina FsRtlAllocateFileLock aloca e inicializa uma nova estrutura de FILE_LOCK.

Sintaxe

PFILE_LOCK FsRtlAllocateFileLock(
  [in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
  [in, optional] PUNLOCK_ROUTINE            UnlockRoutine
);

Parâmetros

[in, optional] CompleteLockIrpRoutine

Um ponteiro para uma rotina de retorno de chamada do tipo PCOMPLETE_LOCK_IRP_ROUTINE a ser chamada quando uma solicitação de IRP_MJ_LOCK_CONTROL for concluída. Esse parâmetro é opcional e pode ser NULL.

[in, optional] UnlockRoutine

Um ponteiro para uma rotina de retorno de chamada do tipo PUNLOCK_ROUTINE a ser chamada quando o intervalo de bytes é desbloqueado. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

FsRtlAllocateFileLock retorna um ponteiro para a estrutura de FILE_LOCK recém-alocada.

Comentários

FsRtlAllocateFileLock aloca uma nova estrutura FILE_LOCK do pool de páginas e a inicializa.

Minifilters devem chamar FltAllocateFileLock em vez de FsRtlAllocateFileLock.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), SpNoWait(storport), StorPortStartIo(storport)