FSCTL_OPLOCK_BREAK_ACKNOWLEDGE código de control

Artículo
09/24/2022
Tiempo de lectura: 2 minutos

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.