codice di controllo FSCTL_REQUEST_OPLOCK_LEVEL_1

Articolo
03/14/2023

Il codice di controllo FSCTL_REQUEST_OPLOCK_LEVEL_1 richiede un blocco opportunistico di livello 1 (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_OPLOCK_LEVEL_1, 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_OPLOCK_LEVEL_1.
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_OPLOCK_LEVEL_1.
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_OPLOCK_LEVEL_1. Si tratta di un codice di errore.
STATUS_OPLOCK_NOT_GRANTED	Impossibile concedere l'oplock. Si tratta di un codice di errore.