Fungsi RxpTrackDereference (fcb.h)

Artikel
02/29/2024

RxpTrackDereference digunakan dalam build yang diperiksa untuk melacak permintaan ke dereferensi SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB, dan struktur SRV_OPEN dalam build yang diperiksa. Log permintaan dereferensi ini dapat diakses oleh sistem pengelogan dan WMI.

Sintaks

BOOLEAN RxpTrackDereference(
  [in] ULONG TraceType,
  [in] PCSTR FileName,
  [in] ULONG Line,
       PVOID Instance
);

Parameter

[in] TraceType

Nilai yang menentukan jenis permintaan dereferensi mana yang dilacak. Nilai ini bisa menjadi salah satu makro berikut yang ditentukan dalam fcb.h:

RDBSS_REF_TRACK_SRVCALL

Permintaan dereferensi pada struktur SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Permintaan dereferensi pada struktur NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Permintaan dereferensi pada struktur V_NET_ROOT.

RDBSS_REF_TRACK_NETFOBX

Permintaan dereferensi pada struktur FOBX.

RDBSS_REF_TRACK_NETFCB

Permintaan dereferensi pada struktur FCB.

RDBSS_REF_TRACK_SRVOPEN

Permintaan dereferensi pada struktur SRV_OPEN.

[in] FileName

Nama file sumber tempat rutinitas ini dipanggil.

[in] Line

Nomor baris dalam file sumber tempat rutinitas ini dipanggil.

Instance

Penunjuk ke struktur yang akan didereferensikan.

Nilai kembali

RxpTrackDereference selalu mengembalikan TRUE pada build yang dicentang.

Keterangan

Dalam build yang diperiksa, RxpTrackDereference digunakan untuk melacak permintaan untuk mendereferensikan struktur SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB, dan SRV_OPEN. Untuk build ritel, fungsi ini tidak melakukan apa-apa.

Jika WMI diaktifkan, log permintaan dereferensi dikirim sebagai peristiwa WMI ke komponen WMI mode pengguna yang telah meminta pemberitahuan. Permintaan penangguhan juga dicatat ke sistem pengelogan RDBSS dengan memanggil rutinitas _RxLog untuk merekam entri log kesalahan I/O jika pengelogan diaktifkan.

Perhatikan bahwa rutinitas ini sebenarnya tidak mendereferensikan struktur yang dilewati (mengurangi jumlah referensi pada struktur).

Sejumlah makro didefinisikan dalam fcb.h untuk penelusuran kesalahan yang merupakan cara yang disukai untuk memanggil rutinitas ini. Makro ini menyediakan pembungkus di sekitar rutinitas RxReference atau RxDereference yang digunakan untuk operasi manajemen struktur file pada struktur SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB, dan SRV_OPEN. Makro ini terlebih dahulu memanggil rutinitas RxpTrackDereference yang sesuai untuk mencatat informasi diagnostik tentang permintaan sebelum memanggil rutinitas RxDereference yang sesuai.