RxSetDomainForMailslotBroadcast 函数 (mrx.h)

项目
10/11/2023

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

语法

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

参数

[in] DomainName

指向缓冲区的指针，该缓冲区包含一个以零结尾的 Unicode 字符串，该字符串命名要用于 mailslot 的域。

返回值

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

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

注解

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

传递给 RxRegisterMinirdr 例程的参数之一指示网络微型重定向程序是否支持 mailslot。网络微型重定向程序通常会从 MrxStart 例程调用 RxSetDomainForMailslotBroadcast，或者作为外部请求的一部分调用，以启动文件系统控件 (FSCTRL) 或 I/O 控件 (IOCTL) 用户模式应用程序或服务的请求。