Função FsRtlAllocateFileLock (ntifs.h)

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 tipada PCOMPLETE_LOCK_IRP_ROUTINEa 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 com tipo PUNLOCK_ROUTINEa ser chamado quando o intervalo de bytes é desbloqueado. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

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

Observações

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

Os minifiltros devem chamar FltAllocateFileLock em vez de FsRtlAllocateFileLock.

Requisitos

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

Consulte também

FltAllocateFileLock

FsRtlAreThereCurrentFileLocks

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFastCheckLockForRead

FsRtlFastCheckLockForWrite

FsRtlFastLock

FsRtlFastUnlockAll

FsRtlFastUnlockAllByKey

FsRtlFastUnlockSingle

FsRtlGetNextFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PCOMPLETE_LOCK_IRP_ROUTINE

PUNLOCK_ROUTINE