Fungsi RxSetDomainForMailslotBroadcast (mrx.h)

Artikel
02/27/2024

RxSetDomainForMailslotBroadcast dipanggil oleh driver mini-redirector jaringan untuk mengatur domain yang digunakan untuk siaran mailslot jika mailslots didukung oleh driver.

Sintaks

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parameter

[in] DomainName

Penunjuk ke buffer yang berisi string Unicode yang dihentikan nol yang menamai domain yang akan digunakan untuk mailslots.

Nilai kembali

RxSetDomainForMailslotBroadcast mengembalikan STATUS_SUCCESS pada keberhasilan atau salah satu nilai kesalahan berikut pada kegagalan:

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Tidak ada cukup sumber daya untuk menyelesaikan rutinitas ini. Permintaan alokasi memori gagal untuk memori kumpulan yang tidak disebarkan untuk menyimpan nama domain.

Keterangan

Pengalih mini jaringan mendaftar dengan RDBSS setiap kali driver dimuat oleh kernel dan membatalkan pendaftaran dengan RDBSS saat driver dibongkar. Proses pendaftaran ini adalah goyangan tangan dua arah di mana pengalih mini jaringan menginformasikan RDBSS bahwa telah dimuat dengan memanggil RxRegisterMinirdr, rutinitas pendaftaran yang diekspor dari RDBSS. RDBSS menyelesaikan proses pendaftaran dan inisialisasi dengan memanggil MrxStart, salah satu rutinitas panggilan balik yang diekspor oleh pengalih mini jaringan dan diteruskan sebagai bagian dari tabel pengiriman ke RxRegisterMinirdr.

Salah satu parameter yang diteruskan ke rutinitas RxRegisterMinirdr menunjukkan apakah pengalih mini jaringan mendukung mailslots. Pengalih mini jaringan biasanya akan memanggil RxSetDomainForMailslotBroadcast dari rutinitas MrxStart atau sebagai bagian dari permintaan eksternal untuk memulai driver yang dimulai oleh kontrol sistem file (FSCTRL) atau permintaan kontrol I/O (IOCTL) dari aplikasi atau layanan mode pengguna.