FSCTL_OPLOCK_BREAK_NOTIFY kode kontrol

Artikel
02/07/2024

Kode kontrol FSCTL_OPLOCK_BREAK_NOTIFY memungkinkan aplikasi panggilan menunggu penyelesaian jeda kunci oportunistik (oplock).

Operasi ini hanya berguna untuk jeda oplock yang sudah dimulai ketika handel penelepon dibuka. Handel harus dibuka dengan FILE_COMPLETE_IF_OPLOCKED. Operasi ini tidak berarti jika oplock saat ini ditahan dan jeda oplock belum dimulai.

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

Blok status

FltOplockFsctrl mengembalikan FLT_PREOP_PENDING jika pembobolan oplock sedang berlangsung, dan IRP akan selesai ketika jeda oplock selesai. (Dalam hal ini, IRP pada akhirnya dapat selesai dengan STATUS_SUCCESS atau STATUS_CANCELLED.) Jika tidak, FltOplockFsctrl mengembalikan FLT_PREOP_COMPLETE.

FsRtlOplockFsctrl mengembalikan salah satu nilai NTSTATUS berikut untuk operasi ini:

Kode	Makna
STATUS_SUCCESS	Tidak ada oplock yang dipegang oleh handel ini, atau oplock ditahan dan jeda oplock belum dimulai.
STATUS_INVALID_OPLOCK_PROTOCOL	IRP dibatalkan sebelum operasi FSCTL_OPLOCK_BREAK_NOTIFY selesai.
STATUS_PENDING	Pembobolan oplock sedang berlangsung. IRP akan selesai ketika pemecahan oplock selesai. IRP pada akhirnya dapat selesai dengan STATUS_SUCCESS atau STATUS_CANCELLED. Ini adalah kode sukses.