Rutinitas MRxDevFcbXXXControlFile
Rutinitas MRxDevFcbXXXControlFile dipanggil oleh RDBSS untuk meneruskan permintaan kontrol FCB perangkat (permintaan IOCTL atau FSCTL) ke pengalihan mini jaringan.
Sintaks
PMRX_CALLDOWN MRxDevFcbXXXControlFile;
NTSTATUS MRxDevFcbXXXControlFile(
_Inout_ PRX_CONTEXT RxContext
)
{ ... }
Parameter
RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.
Mengembalikan nilai
MRxDevFcbXXXControlFile mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_ACCESS_DENIED | Permintaan dibuat untuk menghentikan atau memulai pengalihan mini jaringan, tetapi pemanggil tidak memiliki keamanan yang tepat untuk operasi ini. |
| STATUS_INVALID_DEVICE_REQUEST | Permintaan perangkat yang tidak valid dikirim ke pengalih-mini jaringan. |
| STATUS_REDIRECTOR_HAS_OPEN_HANDLES | Ini adalah permintaan untuk menghentikan pengalihan mini jaringan, tetapi pengalih memiliki handel terbuka yang mencegahnya berhenti saat ini. |
| STATUS_REDIRECTOR_NOT_STARTED | Ini adalah permintaan untuk menghentikan pengalihan mini jaringan, tetapi pengalih tidak dimulai. |
| STATUS_REDIRECTOR_STARTED | Ini adalah permintaan untuk memulai pengalihan mini jaringan, tetapi pengalih sudah dimulai. |
Keterangan
MRxDevFcbXXXControlFile menangani permintaan IOCTL dan FSCTL yang terkait dengan FCB perangkat yang dikirim ke pengalih mini jaringan.
Sebelum memanggil MRxDevFcbXXXControlFile, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditunjukkan oleh parameter RxContext :
MajorFunction diatur ke fungsi utama IRP
Jika ini adalah permintaan IRP_MJ_FILE_SYSTEM_CONTROL, maka RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang diacu oleh parameter RxContext :
LowIoContext.ParamsFor.FsCtl.MinorFunction diatur ke kode fungsi minor untuk kode FSCTL
LowIoContext.ParamsFor.FsCtl.FsControlCode diatur ke kode FSCTL untuk IRP
Jika ini adalah permintaan IRP_MJ_DEVICE_CONTROL atau IRP_MJ_INTERNAL_DEVICE_CONTROL, maka RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditunjukkan oleh parameter RxContext :
LowIoContext.ParamsFor.FsCtl.FsControlCode diatur ke kode kontrol untuk IRP.
Jika MRxDevFcbXXXControlFile mengembalikan STATUS_SUCCESS, maka rutinitas berhasil. Nilai pengembalian lainnya menunjukkan bahwa terjadi kesalahan.
Persyaratan
Platform target |
Desktop |
Header |
Mrx.h (termasuk Mrx.h) |