Funzione FsRtlCheckUpperOplock (ntifs.h)

La routine FsRtlCheckUpperOplock fornisce un controllo di blocco opportunistico (oplock) in file system secondari o a più livelli quando gli oplock che mantengono lo stato di modifica. I file system secondari, ad esempio i reindirizzamenti di rete e i servizi file di clustering, chiamano FsRtlCheckUpperOplock quando un oplock mantenuto in un file system inferiore dal file system secondario cambia stato. Una modifica dello stato può verificarsi da un'interruzione o da un aggiornamento. FsRtlCheckUpperOplock interromperà l'oplock del file system superiore, se necessario, per confermare il nuovo stato di oplock inferiore. Il chiamante può anche fornire callback facoltativi per le notifiche di riconoscimento di interruzione e stato in sospeso.

Sintassi

NTSTATUS FsRtlCheckUpperOplock(
  [in]           POPLOCK                       Oplock,
  [in]           ULONG                         NewLowerOplockState,
  [in, optional] PVOID                         CompletionRoutineContext,
  [in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
                 POPLOCK_FS_PREPOST_IRP        PrePendRoutine,
  [in]           ULONG                         Flags
);

Parametri

[in] Oplock

Puntatore oplock opaco per il file. Questo puntatore deve essere stato inizializzato da una chiamata precedente a FsRtlInitializeOplock.

[in] NewLowerOplockState

Valore che rappresenta l'oplock richiesto mantenuto in un file system inferiore da un file system secondario. Questa combinazione OR bit per bit dei seguenti elementi:

[in, optional] CompletionRoutineContext

Puntatore alle informazioni sul contesto definite dal chiamante da passare alle routine di callback a cui puntano i parametri CompletionRoutine e PrePendIrpRoutine.

[in, optional] CompletionRoutine

Puntatore a una routine di callback fornita dal chiamante. Se è in corso un'interruzione di blocco opportunistica, questa routine viene chiamata al termine dell'interruzione. Questo parametro è facoltativo e può essere NULL. Se è NULL, il chiamante viene inserito in uno stato di attesa fino al completamento dell'interruzione di blocco opportunistica.

La dichiarazione e le descrizioni dei parametri di questa routine sono le seguenti:

typedef VOID
(*POPLOCK_WAIT_COMPLETE_ROUTINE) (
      _In_ PVOID Context,
      _In_opt_ PIRP Irp
      );

PrePendRoutine

Un puntatore a una routine di callback fornita dal chiamante da chiamare se FsRtlCheckUpperOplock restituirà STATUS_PENDING. Questo parametro è facoltativo e può essere NULL.

La dichiarazione e le descrizioni dei parametri di questa routine sono le seguenti:

typedef VOID
(*POPLOCK_FS_PREPOST_IRP) (
      _In_ PVOID Context,
      _in_opt_ PIRP Irp
      );

[in] Flags

Maschera di bit per l'operazione di I/O di file associata. Un file system o un driver di filtro imposta i bit per specificare il comportamento di FsRtlCheckUpperOplock. Il parametro flag include le opzioni seguenti:

Valore restituito

FsRtlCheckUpperOplock restituisce un codice NTSTATUS appropriato, ad esempio uno dei seguenti:

Fabbisogno

Vedere anche

FsRtlCheckOplockEx

FsRtlUpperOplockFsctrl