RxpTrackDereference 函式 (fcb.h)

發行項
02/29/2024

在核取的組建中使用 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。

備註

在核取的組建中， RxpTrackDereference 可用來追蹤取值SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB 和SRV_OPEN結構的要求。對於零售組建，此函式不會執行任何動作。

如果已啟用 WMI，則會將取值要求的記錄當做 WMI 事件傳送至已要求通知的使用者模式 WMI 元件。延遲要求也會藉由呼叫 _RxLog 例程記錄至 RDBSS 記錄系統，以在啟用記錄時記錄 I/O 錯誤記錄專案。

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

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