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 例程。

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