Rutinitas MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK]

Artikel
06/14/2023

Rutinitas MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] dipanggil oleh RDBSS untuk meminta agar pengalih mini jaringan membuka kunci eksklusif pada objek file.

Sintaks

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK];

NTSTATUS MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK](
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parameter

RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.

Mengembalikan nilai

MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_CONNECTION_DISCONNECTED	Sambungan terputus.
STATUS_INSUFFICIENT_RESOURCES	Tidak ada cukup sumber daya untuk menyelesaikan permintaan.
STATUS_INVALID_NETWORK_RESPONSE	Respons yang tidak valid diterima dari server jarak jauh.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan dalam RxContext.
STATUS_LINK_FAILED	Upaya untuk menyambungkan kembali ke server jarak jauh untuk menyelesaikan permintaan gagal.
STATUS_NOT_IMPLEMENTED	Rutinitas ini tidak diimplementasikan.
STATUS_SHARING_VIOLATION	Terjadi pelanggaran berbagi.
STATUS_UNSUCCESSFUL	Panggilan tidak berhasil.

Keterangan

RDBSS memanggil MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] sebagai tanggapan untuk menerima permintaan IRP_MJ_LOCK_CONTROL dengan kode kecil IRP_MN_LOCK jika IrpSp-Flags> memiliki set bit SL_EXCLUSIVE_LOCK.

Sebelum memanggil MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK], RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditujukkan oleh parameter RxContext :

Anggota LowIoContext.Operation diatur ke LOWIO_OP_EXCLUSIVELOCK.

Anggota LowIoContext.ResourceThreadId diatur ke utas proses yang memulai operasi di RDBSS.

Anggota LowIoContext.ParamsFor.Locks.ByteOffset diatur ke nilai IrpSp-Parameters.LockControl.ByteOffset.QuadPart>.

Anggota LowIoContext.ParamsFor.Locks.Key diatur ke nilai IrpSp-Parameters.LockControl.Key>.

Anggota LowIoContext.ParamsFor.Locks.Flags diatur ke nilai IrpSp-Flags>.

Anggota LowIoContext.ParamsFor.Locks.Length diatur ke nilai IrpSp-Parameters.LockControl.Length.QuadPart>.

Anggota LowIoContext.Operation dari struktur RX_CONTEXT menentukan operasi I/O rendah untuk dilakukan. Dimungkinkan bagi beberapa rutinitas I/O rendah untuk menunjuk ke rutinitas yang sama dalam mini-redirector jaringan karena anggota LowIoContext.Operation ini dapat digunakan untuk membedakan operasi I/O rendah yang diminta. Misalnya, semua panggilan I/O yang terkait dengan kunci file dapat memanggil rutinitas I/O rendah yang sama di pengalih mini jaringan dan rutinitas tersebut dapat menggunakan anggota LowIoContext.Operation untuk membedakan antara operasi kunci dan buka kunci yang diminta.

Jika rutinitas MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] dapat memakan waktu lama untuk diselesaikan, driver pengalih mini jaringan harus merilis struktur FCB sebelum memulai komunikasi jaringan. Struktur FCB dapat dirilis dengan memanggil RxReleaseFcbResourceForThreadInMRx. Sementara rutinitas MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] sedang diproses, anggota LowIoContext.ResourceThreadId dari RX_CONTEXT dijamin menunjukkan utas proses yang memulai operasi di RDBSS.

Anggota LowIoContext.ResourceThreadId dari RX_CONTEXT dapat digunakan untuk merilis struktur FCB atas nama utas lain. Ketika rutinitas asinkron selesai, struktur FCB yang diperoleh dari utas awal dapat dirilis.