RxpTrackReference 函数 (fcb.h)

项目
02/29/2024

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 组件。如果启用了日志记录，则通过调用 _RxLog 例程来记录 I/O 错误日志条目，从而将延迟请求记录到 RDBSS 日志记录系统。

请注意，此例程实际上并不引用传递的结构， (增加结构) 的引用计数。

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

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