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 |