RxpDereferenceNetFcb 函数 (fcb.h)

项目
02/26/2024

RxpDereferenceNetFcb 递减 FCB 结构上的引用计数。

语法

LONG RxpDereferenceNetFcb(
  PFCB Fcb
);

参数

Fcb

指向要取消引用的 FCB 结构的指针。

返回值

RxpDereferenceNetFcb 在取消引用后返回最终引用计数。

注解

FCB 的引用和取消引用不同于其他数据结构，因为 FCB 中的嵌入资源。这意味着调用方需要有关 FCB 状态的信息， (它是否 ) 完成。若要完成 FCB，需要保留两个锁，即NET_ROOT名称表锁以及 FCB 资源。这些注意事项会导致取消引用 FDB 时采用不同的方法。因此， RxpDereferenceNetFcb 不会尝试完成 FCB。

fcb.h 中定义了许多用于调试的宏，这些宏是调用此例程的首选方法。这些宏围绕用于 FCB 结构上的文件结构管理操作的 RxpReferenceNetFcb 或 RxpDereferenceNetFcb 例程提供包装器。 RxDereferenceNetFcb 宏是调用此例程的首选方法。此宏首先调用 RxpTrackDereference 例程，以记录有关请求的诊断信息，然后再调用 RxpDereferenceNetFcb 例程。

在检查的生成中，如果结构的节点类型不是 FCB 或最终引用计数小于 0， 则 RxpDereferenceNetFcb 会导致系统执行 ASSERT。