FSCTL_REQUEST_BATCH_OPLOCK código de control

El FSCTL_REQUEST_BATCH_OPLOCK código de control solicita un bloqueo oportunista por lotes (oplock) en un archivo.

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 código de control FSCTL_REQUEST_BATCH_OPLOCK, consulte la documentación de Microsoft Windows SDK.

Parámetros

  • Oplock: puntero de objeto oplock opaco para el archivo.

  • CallbackData: FltOplockFsctrl solo. Estructura de datos de devolución de llamada (FLT_CALLBACK_DATA) para una solicitud IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. El parámetro FsControlCode para la operación debe ser FSCTL_REQUEST_BATCH_OPLOCK.

  • Irp: solo FsRtlOplockFsctrl . IRP para una solicitud IRP_MJ_FILE_SYSTEM_CONTROL FSCTL. El parámetro FsControlCode para la operación debe ser FSCTL_REQUEST_BATCH_OPLOCK.

  • OpenCount: número de identificadores de usuario para el archivo.

Bloque de estado

FltOplockFsctrl devuelve FLT_PREOP_PENDING para esta operación si se concedió el oplock. De lo contrario, devuelve FLT_PREOP_COMPLETE.

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

Código Significado
STATUS_PENDING Se concedió el interbloqueo. Se trata de un código de éxito.
STATUS_CANCELLED El IRP se canceló antes de que se completara la operación de FSCTL_REQUEST_BATCH_OPLOCK. Se trata de un código de error.
STATUS_OPLOCK_NOT_GRANTED No se pudo conceder el interbloqueo. Se trata de un código de error.

Requisitos

Tipo de requisito Requisito
Encabezado Ntifs.h (incluya Ntifs.h o Fltkernel.h)

Consulte 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_ACKNOWLEDGE

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_1

FSCTL_REQUEST_OPLOCK_LEVEL_2

FsRtlOplockFsctrl

IRP_MJ_FILE_SYSTEM_CONTROL