Funzione FsRtlOplockBreakH (ntifs.h)

La routine FsRtlOplockBreakH interrompe CACHE_HANDLE_LEVEL blocchi opportunistici (oplock).

Sintassi

NTSTATUS FsRtlOplockBreakH(
  [in]           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] Oplock

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

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

Specifica per consentire a un'interruzione di oplock di procedere senza bloccare o in sospeso l'operazione che ha causato l'interruzione del blocco.

OPLOCK_FLAG_IGNORE_OPLOCK_KEYS (0x00000008)

Supportato in Windows 7 e versioni successive.

Specifica per consentire CACHE_HANDLE_LEVEL interruzioni di oplock di procedere indipendentemente dalla chiave di blocco.

[in, optional] Context

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

[in, optional] CompletionRoutine

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

Questa routine viene dichiarata come segue:

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

Questa routine include i parametri seguenti:

Contesto

Puntatore alle informazioni di contesto passato al parametro Context a FsRtlOplockBreakH.

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 pennata. La routine viene chiamata prima che il pacchetto oplock pend 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 al parametro Context a FsRtlOplockBreakH.

Irp

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

Valore restituito

FsRtlOplockBreakH 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	L'IRP è stato pubblicato in una coda di lavoro. STATUS_PENDING è un codice riuscito.
STATUS_CANNOT_BREAK_OPLOCK	Impossibile eseguire l'interruzione del blocco opportunistico (oplock). L'IRP è una richiesta di IRP_MJ_CREATE. FILE_OPEN_REQUIRING_OPLOCK è stato specificato nel parametro delle opzioni di creazione per l'operazione e viene concesso un oplock concesso. STATUS_CANNOT_BREAK_OPLOCK è un codice di errore.

Commenti

Quando un'operazione deve interrompere CACHE_HANDLE_LEVEL oplock, l'operazione chiama FsRtlOplockBreakH.

Se il chiamante specifica il flag di OPLOCK_FLAG_IGNORE_OPLOCK_KEYS nel parametro Flags , FsRtlOplockBreakH interrompe tutti gli oplock CACHE_HANDLE_LEVEL, indipendentemente dalla chiave oplock. Il comportamento predefinito di FsRtlOplockBreakH consiste nell'interrompere gli oplock i cui tasti non corrispondono alla chiave nell'oggetto file del chiamante.

I minifiltri devono chiamare FltOplockBreakH anziché FsRtlOplockBreakH.

Requisiti

Requisito	Valore
Client minimo supportato	La routine FsRtlOplockBreakH è 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

Vedi anche

FltOplockBreakH

FsRtlInitializeOplock