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 中定义了许多宏,用于调试,这是调用此例程的首选方法。 这些宏围绕 RxReference 或 RxDereference 例程提供包装器,这些例程用于对SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和SRV_OPEN结构执行文件结构管理作。 这些宏首先调用相应的 RxpTrackDereference 例程,以记录有关请求的诊断信息,然后再调用相应的 RxDereference 例程。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | fcb.h (包括 Fcb.h) |
IRQL | <= APC_LEVEL |