codice di controllo FSCTL_REQUEST_BATCH_OPLOCK

Il codice di controllo FSCTL_REQUEST_BATCH_OPLOCK richiede un blocco opportunistico batch (oplock) in un file.

Per elaborare questo codice di controllo, un minifilter chiama FltOplockFsctrl con i parametri seguenti. Un file system o un driver di filtro legacy chiama FsRtlOplockFsctrl.

Per altre informazioni sul blocco opportunistico e sul codice di controllo FSCTL_REQUEST_BATCH_OPLOCK, vedere la documentazione di Microsoft Windows SDK.

Parametri

  • Oplock: puntatore dell'oggetto oplock opaco per il file.

  • CallbackData: solo FltOplockFsctrl . Struttura dei dati di callback (FLT_CALLBACK_DATA) per una richiesta IRP_MJ_FILE_SYSTEM_CONTROL. Il parametro FsControlCode per l'operazione deve essere FSCTL_REQUEST_BATCH_OPLOCK.

  • Irp: solo FsRtlOplockFsctrl . IRP per una richiesta IRP_MJ_FILE_SYSTEM_CONTROL IRP_MJ_FILE_SYSTEM_CONTROL. Il parametro FsControlCode per l'operazione deve essere FSCTL_REQUEST_BATCH_OPLOCK.

  • OpenCount: numero di handle utente per il file.

Blocco dello stato

FltOplockFsctrl restituisce FLT_PREOP_PENDING per questa operazione se è stato concesso l'oplock. In caso contrario, restituisce FLT_PREOP_COMPLETE.

FsRtlOplockFsctrl restituisce uno dei valori NTSTATUS seguenti per questa operazione:

Codice Significato
STATUS_PENDING L'oplock è stato concesso. Si tratta di un codice di operazione riuscita.
STATUS_CANCELLED L'IRP è stato annullato prima del completamento dell'operazione di FSCTL_REQUEST_BATCH_OPLOCK. Si tratta di un codice di errore.
STATUS_OPLOCK_NOT_GRANTED Impossibile concedere l'oplock. Si tratta di un codice di errore.

Requisiti

Tipo di requisito Requisito
Intestazione Ntifs.h (include Ntifs.h o Fltkernel.h)

Vedi anche

FLT_CALLBACK_DATA

FLT_PARAMETERS

FLT_PARAMETERS per 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