RxSetDomainForMailslotBroadcast 函数 (mrx.h)
网络微型重定向程序驱动程序调用 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) 用户模式应用程序或服务的请求。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | mrx.h (包括 Mrx.h) |
IRQL | <= APC_LEVEL |