Condividi tramite

Funzione FsRtlOplockBreakToNoneEx (ntifs.h)

  • Articolo

Il FsRtlOplockBreakToNoneEx routine interrompe immediatamente tutti i blocchi opportunistici (oplock) senza considerare alcuna chiave oplock.

Sintassi

NTSTATUS FsRtlOplockBreakToNoneEx(
  [in, out]      POPLOCK                       Oplock,
  [in]           PIRP                          Irp,
  [in]           ULONG                         Flags,
  [in, optional] PVOID                         Context,
  [in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
  [in, optional] POPLOCK_FS_PREPOST_IRP        PostIrpRoutine
);

Parametri

[in, out] Oplock

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

[in] Irp

Puntatore all'IRP per l'operazione di I/O.

[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 FsRtlOplockBreakToNoneEx. Il parametro flag include le opzioni seguenti:

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

Specifica di consentire a un'interruzione di oplock di continuare senza bloccare o in sospeso l'operazione che ha causato l'interruzione di oplock. In genere, questo flag viene usato solo se l'IRP a cui punta il parametro Irp dichiara un'operazione di IRP_MJ_CREATE.

[in, optional] Context

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

[in, optional] CompletionRoutine

Puntatore a una routine di callback fornita dal chiamante. Se è in corso un'interruzione di oplock, 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 oplock.

Questa routine viene dichiarata come segue:

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

Questa routine presenta i parametri seguenti:

Contesto

Puntatore alle informazioni di contesto passato nel parametro context a FsRtlOplockBreakToNoneEx.

Irp

Puntatore all'IRP per l'operazione di I/O.

[in, optional] PostIrpRoutine

Puntatore a una routine di callback fornita dal chiamante da chiamare se l'operazione di I/O deve essere sospesa. La routine viene chiamata prima che il pacchetto oplock eseprima l'IRP. Questo parametro è facoltativo e può essere NULL.

Questa routine viene dichiarata come segue:

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

Contesto

Puntatore alle informazioni di contesto passato nel parametro context a FsRtlOplockBreakToNoneEx.

Irp

Puntatore all'IRP per l'operazione di I/O.

Valore restituito

FsRtlOplockBreakToNoneEx restituisce STATUS_SUCCESS o un codice NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito Descrizione
STATUS_CANCELLED
 L'IRP è stato annullato. STATUS_CANCELLED è un codice di errore.
STATUS_PENDING
 È in corso un'interruzione di blocco. Pertanto, l'IRP è stato pennato. STATUS_PENDING è un codice riuscito.
STATUS_OPLOCK_BREAK_IN_PROGRESS
 È in corso un'interruzione di blocco opportunistica (oplock). STATUS_OPLOCK_BREAK_IN_PROGRESS è un codice riuscito che FsRtlOplockBreakToNoneEx restituisce se il chiamante imposta OPLOCK_FLAG_COMPLETE_IF_OPLOCKED nel parametro Flag e un oplock deve essere interrotto.

Osservazioni

Per altre informazioni sui blocchi opportunistici, vedere la documentazione di Microsoft Windows SDK.

I minifiltri devono chiamare FltOplockBreakToNoneEx anziché FsRtlOplockBreakToNoneEx.

Fabbisogno

Requisito Valore
client minimo supportato La routine FsRtlOplockBreakToNoneEx è disponibile a partire da Windows 7.
piattaforma di destinazione Universale
intestazione ntifs.h (include Ntifs.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL <= APC_LEVEL

Vedere anche

FltOplockBreakToNoneEx

FsRtlInitializeOplock