FSCTL_OPLOCK_BREAK_ACKNOWLEDGE kode kontrol

Artikel
03/14/2023

Kode kontrol FSCTL_OPLOCK_BREAK_ACKNOWLEDGE merespons pemberitahuan bahwa kunci oportunistik (oplock) eksklusif (tingkat 1, batch, atau filter) pada file telah rusak.

Aplikasi klien mengirim kode kontrol ini untuk menunjukkan bahwa ia mengakui jeda oplock dan bahwa, jika oplock adalah oplock tingkat 1 yang rusak ke tingkat 2, itu memang menginginkan oplock tingkat 2.

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_OPLOCK_BREAK_ACKNOWLEDGE , lihat dokumentasi Microsoft Windows SDK.

Parameter

Oplock: Penunjuk objek oplock buram untuk file.
CallbackData: FltOplockFsctrl saja. Struktur data panggilan balik (FLT_CALLBACK_DATA) untuk permintaan FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. Parameter FsControlCode untuk operasi harus FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.
Irp: FsRtlOplockFsctrl saja. IRP untuk permintaan FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. Parameter FsControlCode untuk operasi harus FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.
OpenCount: Tidak digunakan dengan operasi ini; atur ke nol.

Blok status

FltOplockFsctrl mengembalikan FLT_PREOP_PENDING untuk operasi ini ketika oplock level 1 dipecah ke tingkat 2, dan oplock level 2 telah diberikan. Jika tidak, ia mengembalikan FLT_PREOP_COMPLETE.

FsRtlOplockFsctrl mengembalikan salah satu nilai NTSTATUS berikut untuk operasi ini:

Kode	Makna
STATUS_SUCCESS	Pembobolan oplock diakui. Tidak ada oplock yang tersisa yang ditahan.
STATUS_INVALID_OPLOCK_PROTOCOL	Tidak ada oplock yang dipegang oleh handel ini, atau jeda oplock saat ini tidak sedang berlangsung. Ini adalah kode kesalahan.
STATUS_PENDING	Pembobolan oplock diakui. Saat kembali, pengirim kode kontrol FSCTL_OPLOCK_BREAK_ACKNOWLEDGE memegang oplock tingkat 2. Ini adalah kode sukses.