Funzione FsRtlCheckUpperOplock (ntifs.h)

La routine FsRtlCheckUpperOplock fornisce il controllo del blocco opportunistico (oplock) nei file system secondari o a più livelli quando gli oplock contengono 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 conferma di interruzione e lo 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 a 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 completamento 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

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 del file associata. Un file system o un driver di filtro imposta i bit per specificare il comportamento di FsRtlCheckUpperOplock. Il parametro Flags include le opzioni seguenti:

Valore restituito

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

Requisiti

Vedi anche

FsRtlCheckOplockEx

FsRtlUpperOplockFsctrl