RxpTrackDereference 函数 (fcb.h)

项目
02/26/2024

RxpTrackDereference 用于在已检查的生成中跟踪取消引用SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和SRV_OPEN结构的请求。日志记录系统和 WMI 可以访问这些取消引用请求的日志。

语法

BOOLEAN RxpTrackDereference(
  [in] ULONG TraceType,
  [in] PCSTR FileName,
  [in] ULONG Line,
       PVOID Instance
);

参数

[in] TraceType

确定跟踪的取消引用请求类型的值。此值可以是 fcb.h 中定义的以下宏之一：

RDBSS_REF_TRACK_SRVCALL

SRV_CALL 结构的取消引用请求。

RDBSS_REF_TRACK_NETROOT

NET_ROOT 结构的取消引用请求。

RDBSS_REF_TRACK_VNETROOT

V_NET_ROOT 结构的取消引用请求。

RDBSS_REF_TRACK_NETFOBX

FOBX 结构的取消引用请求。

RDBSS_REF_TRACK_NETFCB

FCB 结构的取消引用请求。

RDBSS_REF_TRACK_SRVOPEN

SRV_OPEN结构的取消引用请求。

[in] FileName

调用此例程的源文件的名称。

[in] Line

源文件中调用此例程的行号。

Instance

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

返回值

RxpTrackDereference 在选中的版本上始终返回 TRUE 。

注解

在已检查的版本中， RxpTrackDereference 用于跟踪取消引用SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和SRV_OPEN结构的请求。对于零售版本，此函数不执行任何操作。

如果启用了 WMI，取消引用请求的日志将作为 WMI 事件发送到已请求通知的用户模式 WMI 组件。如果启用了日志记录，则通过调用 _RxLog 例程来记录 I/O 错误日志条目，从而将延迟请求记录到 RDBSS 日志记录系统。

请注意，此例程实际上不会取消引用传递的结构， (减少结构) 的引用计数。

fcb.h 中为调试定义了许多宏，这些宏是调用此例程的首选方法。这些宏围绕 RxReference 或 RxDereference 例程提供包装，这些例程用于对 SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和 SRV_OPEN 结构执行文件结构管理操作。这些宏首先调用相应的 RxpTrackDereference 例程，以记录有关请求的诊断信息，然后再调用相应的 RxDereference 例程。