RxSetDomainForMailslotBroadcast 函数（mrx.h）

项目
02/07/2025

RxSetDomainForMailslotBroadcast 由网络微型重定向程序驱动程序调用，以便在驱动程序支持 mailslot 时设置用于 mailslot 广播的域。

语法

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

参数

[in] DomainName

指向包含零终止 Unicode 字符串的缓冲区的指针，该字符串将域命名为用于 mailslots。

返回值

RxSetDomainForMailslotBroadcast 返回成功时STATUS_SUCCESS或失败时出现以下错误值之一：

返回代码	描述
STATUS_INSUFFICIENT_RESOURCES	没有足够的资源来完成此例程。非分页池内存存储域名的内存分配请求失败。

言论

每当内核加载驱动程序并在卸载驱动程序时注销 RDBSS 时，网络微型重定向程序将注册到 RDBSS。此注册过程是双向握手，网络微型重定向程序通过调用 RxRegisterMinirdr（从 RDBSS 导出的注册例程）通知 RDBSS 已加载它。 RDBSS 通过调用 MrxStart来完成注册和初始化过程，这是网络微型重定向程序导出的回调例程之一，并作为调度表的一部分传入，以 RxRegisterMinirdr。

传递给 RxRegisterMinirdr 例程的参数之一指示网络微型重定向程序是否支持 mailslots。网络微型重定向程序通常从 MrxStart 例程或外部请求调用 RxSetDomainForMailslotBroadcast，或者作为从用户模式应用程序或服务启动的驱动程序启动驱动程序的外部请求的一部分。