Macro FsRtlFastLock (ntifs.h)

Artículo
12/21/2024

Los sistemas de archivos usan la macro de FsRtlFastLock y los controladores de filtro para solicitar un bloqueo de intervalo de bytes para una secuencia de archivos.

Sintaxis

BOOLEAN
FsRtlFastLock( A1,   /* FileLock            */
               A2,   /* FileObject          */
               A3,   /* FileOffset          */
               A4,   /* Length              */
               A5,   /* ProcessId           */
               A6,   /* Key                 */
               A7,   /* FailImmediately     */
               A8,   /* ExclusiveLock       */
               A9,   /* Iosb                */
               A10,  /* Context             */
               A11   /* AlreadySynchronized */ )

Parámetros

A1

[in] FileLock: puntero a la estructura FILE_LOCK del archivo. Esta estructura debe haberse inicializado mediante una llamada anterior a FsRtlAllocateFileLock o FsRtlInitializeFileLock.

A2

[in] FileObject: puntero al FILE_OBJECT del archivo abierto. El objeto de archivo debe haberse creado con GENERIC_READ o GENERIC_WRITE acceso al archivo (o ambos).

A3

[in] FileOffset: puntero a una variable que especifica el desplazamiento de bytes inicial dentro del archivo del intervalo que se va a bloquear.

A4

[in] Longitud: puntero a una variable que especifica la longitud en bytes del intervalo que se va a bloquear.

A5

[in] ProcessId: puntero al identificador de proceso EPROCESS para el proceso que solicita el bloqueo de intervalo de bytes.

A6

[in] Key: la clave que se va a asignar al bloqueo de intervalo de bytes.

A7

[in] FailImmediately: valor booleano que especifica si se debe producir un error en la solicitud de bloqueo si no se puede conceder el bloqueo inmediatamente. Si el autor de la llamada se puede colocar en un estado de espera hasta que se concede la solicitud, establezca FailImmediately en FALSE. Si no es así, establezca FailImmediately en TRUE.

A8

[in] ExclusiveLock: se establece en TRUE si se solicita un bloqueo exclusivo, FALSE si se solicita un bloqueo compartido.

A9

[out] Iosb: puntero a una estructura de IO_STATUS_BLOCK asignada por el autor de la llamada que recibe información de estado sobre la solicitud de bloqueo.

A10

[in] Context: puntero opcional a un contexto que se usará al liberar el bloqueo de intervalo de bytes.

A11

[in] YaSynchronized: este parámetro está obsoleto, pero se conserva para la compatibilidad con los controladores heredados.

Valor devuelto

Ninguno

Observaciones

La macro FsRtlFastLock hace que el autor de la llamada adquiera un bloqueo de intervalo de bytes en una región del archivo especificado.

FsRtlFastLock devuelve TRUE para indicar que la estructura de IO_STATUS_BLOCK apuntada por Iosb recibió información de estado sobre la operación de bloqueo; de lo contrario, devuelve FALSE.

Para examinar el contenido de la estructura a la que apunta iosb, use la macro NT_STATUS.