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 |
|---|---|
|
L'IRP è stato annullato. STATUS_CANCELLED è un codice di errore. |
|
L'IRP è stato pubblicato in una coda di lavoro. STATUS_PENDING è un codice riuscito. |
|
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 |