RxpTrackReference 函式 (fcb.h)

發行項
02/26/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 元件。如果啟用記錄，則延遲要求也會記錄到 RDBSS 記錄系統，方法是呼叫 _RxLog 例程來記錄 I/O 錯誤記錄專案。

請注意，這個例程實際上不會參考傳遞的結構， (遞增結構上的參考計數) 。

在fcb.h中定義許多宏以進行偵錯，這是呼叫此例程的慣用方式。這些宏提供 RxReference 或 RxDereference 例程的包裝函式，用於SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和 SRV_OPEN 結構上的檔案結構管理作業。這些宏會先呼叫對應的 RxpTrackReference 例程，以記錄有關要求的診斷資訊，然後再呼叫對應的 RxReference 例程。

對於零售組建，此函式不會執行任何動作。