RxFinalizeNetRoot 函数 (fcb.h)
RxFinalizeNetRoot 完成给定的NET_ROOT结构。 调用方必须在与设备对象关联的 netname 表上具有排他锁。
语法
BOOLEAN RxFinalizeNetRoot(
[out] OUT PNET_ROOT ThisNetRoot,
[in] IN BOOLEAN RecursiveFinalize,
[in] IN BOOLEAN ForceFinalize
);
参数
[out] ThisNetRoot
指向要完成的NET_ROOT结构的指针。
[in] RecursiveFinalize
指示是否应以递归方式完成最终化的值。
[in] ForceFinalize
指示是否应强制进行最终化的值,而不考虑引用计数。
如果 ForceFinalizeFALSE,则 ThisNetRoot 指向的 NET_ROOT 结构的 NodeReferenceCount 成员必须为 1 才能完成NET_ROOT。
返回值
RxFinalizeNetRoot 返回成功 TRUE;如果未进行最终化,则返回 FALSE FALSE:如果已完成NET_ROOT的终结,RxFinalizeNetRoot 将返回 FALSE。
言论
RxFinalizeNetRoot 例程通常不是由网络微型重定向程序驱动程序直接调用的。 当NET_ROOT的引用计数递减为 1 时,RDBSS 会在内部调用此例程。
在调用 RxFinalizeNetRoot之前,必须以独占模式获取与设备对象关联的 netname 表上的锁。
如果 RecursiveFinalize 参数 TRUE,则 RxFinalizeNetRoot 将清除与此NET_ROOT关联的任何孤立 FCB 结构。 这些孤立的 FCB 是 FcbState 成员设置了FCB_STATE_ORPHANED标志的结构。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | fcb.h (包括 Fcb.h、Mrxfcb.h) |
IRQL | <= APC_LEVEL |