RxpUnregisterMinirdr 函数 (mrx.h)

项目
02/29/2024

网络微型重定向程序驱动程序调用 RxpUnregisterMinirdr，以取消向 RDBSS 注册驱动程序，并从内部 RDBSS 注册表中删除注册信息。

语法

void RxpUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

参数

[in] RxDeviceObject

指向此网络重定向器的 RDBSS 设备对象的指针。

返回值

无

备注

RxpUnregisterMinirdr 例程使用 RDBSS 注销驱动程序，并从内部 RDBSS 注册表中删除注册信息。如果已初始化名称表，则将完成这些表以供发布。对网络微型重定向程序的任何未完成的异步请求将被关闭，与重定向程序关联的任何工作线程都将被关闭。 RxpUnregisterMinirdr 还尝试通过调用 IoDeleteDevice 从系统中删除设备对象。

RxpUnregisterMinirdr 例程通常是由于用户模式应用程序或服务发出的 FSCTL 或 IOCTL 请求卸载网络微型重定向程序的结果调用的，但也可以从网络微型重定向器或作为操作系统关闭处理的一部分进行此调用，或者由于 DriverEntry 例程失败。

请注意，内联例程 RxUnregisterMinirdr 是使用 RDBSS 取消注册驱动程序的首选方法。 RxUnregisterMinirdr 内联例程调用 RxpUnregisterMinirdr，但也会递减对象对 RDBSS 设备对象的引用，以便系统可以释放此对象。