FSCTL_OPLOCK_BREAK_ACKNOWLEDGE código de control

El FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control responde a la notificación de que se ha roto un bloqueo oportunista exclusivo (nivel 1, lote o filtro) en un archivo.

Una aplicación cliente envía este código de control para indicar que confirma la interrupción del bloqueo operativo y que, si el bloqueo de operación es un bloqueo de nivel 1 que se ha roto en el nivel 2, quiere el bloqueo de operación de nivel 2.

Para procesar este código de control, un minifiltro llama a FltOplockFsctrl con los parámetros siguientes. Un sistema de archivos o un controlador de filtro heredado llama a FsRtlOplockFsctrl.

Para obtener más información sobre el bloqueo oportunista y sobre el FSCTL_OPLOCK_BREAK_ACKNOWLEDGE de control, consulte la documentación Microsoft Windows SDK datos.

Parámetros

Oplock
Puntero de objeto oplock oplock oplock para el archivo.

CallbackData
FltOplockFsctrl only. Estructura de datos de devolución FLT_CALLBACK_DATA de llamada para una IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. El parámetro FsControlCode de la operación debe ser FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.

Irp
FsRtlOplockFsctrl only. IRP para una IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. El parámetro FsControlCode de la operación debe ser FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.

OpenCount
No se usa con esta operación; se establece en cero.

Bloque de estado

FltOplockFsctrl devuelve FLT_PREOP_PENDING para esta operación cuando un bloqueo de operación de nivel 1 se divide en el nivel 2 y se ha concedido el oplock de nivel 2. De lo contrario, devuelve FLT_PREOP_COMPLETE.

FsRtlOplockFsctrl devuelve uno de los siguientes valores NTSTATUS para esta operación:

Término Descripción

STATUS_SUCCESS

Se confirma la interrupción del bloqueo operativo. No se mantienen los bloqueos de operación restantes.

STATUS_INVALID_OPLOCK_PROTOCOL

Este identificador no ha mantenido ningún bloqueo de operación o la interrupción del bloqueo no está en curso actualmente. Se trata de un código de error.

STATUS_PENDING

Se confirma la interrupción del bloqueo operativo. En la devolución, el remitente del FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control contiene un bloqueo de nivel 2. Se trata de un código correcto.

Requisitos

Encabezado

Ntifs.h (incluya Ntifs.h o Fltkernel.h)

Vea también

FLT_CALLBACK_DATA

FLT_PARAMETERS

FLT_PARAMETERS para IRP_MJ_FILE_SYSTEM_CONTROL

FltOplockFsctrl

FSCTL_OPBATCH_ACK_CLOSE_PENDING

FSCTL_OPLOCK_BREAK_ACK_NO_2

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_BATCH_OPLOCK

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_1

FSCTL_REQUEST_OPLOCK_LEVEL_2

FsRtlOplockFsctrl

IRP_MJ_FILE_SYSTEM_CONTROL