共用方式為


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