RxpTrackReference 函数（fcb.h）

项目
02/06/2025

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

语法

void RxpTrackReference(
  ULONG TraceType,
  PCSTR FileName,
  ULONG Line,
  PVOID Instance
);

参数

TraceType

[in]确定跟踪哪些引用请求类型的值。此值可以是 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结构的引用请求。

FileName

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

Line

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

Instance

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

返回值

没有

言论

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

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

请注意，此例程实际上不会引用传递的结构（增加结构的引用计数）。

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

对于零售版本，此函数不执行任何作。