FSCTL_OPBATCH_ACK_CLOSE_PENDING kode kontrol

Artikel
02/07/2024

Kode kontrol FSCTL_OPBATCH_ACK_CLOSE_PENDING merespons pemberitahuan bahwa kunci oportunistik (oplock) eksklusif (tingkat 1, batch, atau filter) pada file telah rusak. Aplikasi klien mengirimkan kode kontrol ini untuk menunjukkan bahwa ia mengakui jeda oplock dan akan menutup handel file.

Untuk pemutusan batch atau filter oplock, pemanggil harus menutup handel filenya setelah mengirim kode kontrol ini. Jika tidak, sistem akan memblokir menunggu handel file ditutup.

Kode kontrol ini tidak dimaksudkan untuk digunakan dengan oplock tingkat 1. Namun demikian, untuk jeda oplock tingkat 1, sistem memperlakukan kode kontrol ini sebagai pengakuan lengkap tentang jeda, dan pemanggil tidak diperlukan untuk menutup handel file.

Kode kontrol ini jarang digunakan. Ketika aplikasi klien diberi tahu tentang pemutusan oplock untuk file, dan menutup handelnya untuk file, sistem memperlakukan handel file menutup sebagai pengakuan lengkap tentang jeda oplock. Dengan demikian tidak perlu mengirim kode kontrol ini.

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_OPBATCH_ACK_CLOSE_PENDING, 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_OPBATCH_ACK_CLOSE_PENDING.
Irp: FsRtlOplockFsctrl saja. IRP untuk permintaan FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. Parameter FsControlCode untuk operasi harus FSCTL_OPBATCH_ACK_CLOSE_PENDING.
OpenCount: Tidak digunakan dengan operasi ini; atur ke nol.

Blok status

FltOplockFsctrl selalu mengembalikan FLT_PREOP_COMPLETE untuk operasi ini.

FsRtlOplockFsctrl mengembalikan salah satu nilai NTSTATUS berikut untuk operasi ini:

Kode	Makna
STATUS_SUCCESS	Oplock yang dipegang oleh handel ini sedang dalam proses rusak.
STATUS_INVALID_OPLOCK_PROTOCOL	Tidak ada oplock yang dipegang oleh handel ini, atau jeda oplock saat ini tidak sedang berlangsung. Ini adalah kode kesalahan.