FSCTL_REQUEST_OPLOCK_LEVEL_2 kode kontrol
Kode kontrol FSCTL_REQUEST_OPLOCK_LEVEL_2 meminta kunci oportunistik tingkat 2 (oplock) pada file.
Untuk memproses kode kontrol ini, minifilter memanggil FltOplockFsctrl dengan parameter berikut. Sistem file atau driver filter warisan memanggil FsRtlOplockFsctrl.
Untuk informasi selengkapnya tentang penguncian oportunistik dan tentang kode kontrol FSCTL_REQUEST_OPLOCK_LEVEL_2 , lihat dokumentasi Microsoft Windows SDK.
Parameter
Oplock: Penunjuk objek oplock buram untuk file.
CallbackData: Hanya FltOplockFsctrl . Struktur data panggilan balik (FLT_CALLBACK_DATA) untuk permintaan FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. Parameter FsControlCode untuk operasi harus FSCTL_REQUEST_OPLOCK_LEVEL_2.
Irp: Hanya FsRtlOplockFsctrl . IRP untuk permintaan FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. Parameter FsControlCode untuk operasi harus FSCTL_REQUEST_OPLOCK_LEVEL_2.
OpenCount: Menentukan status penguncian file. Atur parameter ini ke nilai ULONG bukan nol jika ada kunci rentang byte pada file, atau nol sebaliknya.
Blok status
FltOplockFsctrl mengembalikan FLT_PREOP_PENDING untuk operasi ini jika oplock diberikan. Jika tidak, ia mengembalikan FLT_PREOP_COMPLETE.
FsRtlOplockFsctrl mengembalikan salah satu nilai NTSTATUS berikut untuk operasi ini:
| Kode | Makna |
|---|---|
| STATUS_PENDING | Oplock diberikan. Ini adalah kode keberhasilan. |
| STATUS_CANCELLED | IRP dibatalkan sebelum operasi FSCTL_REQUEST_OPLOCK_LEVEL_2 selesai. Ini adalah kode kesalahan. |
| STATUS_OPLOCK_NOT_GRANTED | Oplock tidak dapat diberikan. Ini adalah kode kesalahan. |
Persyaratan
| Jenis persyaratan | Persyaratan |
|---|---|
| Header | Ntifs.h (termasuk Ntifs.h atau Fltkernel.h) |
Lihat juga
FLT_PARAMETERS untuk IRP_MJ_FILE_SYSTEM_CONTROL
FSCTL_OPBATCH_ACK_CLOSE_PENDING