RxpTrackDereference 函数 (fcb.h)

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 true

言论

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

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

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

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

要求

要求 价值
目标平台 桌面
标头 fcb.h (包括 Fcb.h)
IRQL <= APC_LEVEL

另请参阅

RxAssert

RxDbgBreakPoint

RxDereference

RxReference

RxpTrackReference

_RxLog