Fungsi RxpTrackReference (fcb.h)

Artikel
02/29/2024

RxpTrackReference melacak permintaan untuk mereferensikan struktur SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB, dan SRV_OPEN dalam build yang diperiksa. Log permintaan referensi ini dapat diakses oleh sistem pengelogan dan WMI.

Sintaks

void RxpTrackReference(
  ULONG TraceType,
  PCSTR FileName,
  ULONG Line,
  PVOID Instance
);

Parameter

TraceType

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

Nilai	Makna
RDBSS_REF_TRACK_SRVCALL	Permintaan referensi pada struktur SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Permintaan referensi pada struktur NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Permintaan referensi pada struktur V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX	Permintaan referensi pada struktur FOBX.
RDBSS_REF_TRACK_NETFCB	Permintaan referensi pada struktur FCB.
RDBSS_REF_TRACK_SRVOPEN	Permintaan referensi pada struktur SRV_OPEN.

FileName

[in] Nama file sumber tempat rutinitas ini dipanggil.

Line

[in] Nomor baris dalam file sumber tempat rutinitas ini dipanggil.

Instance

Penunjuk ke struktur yang akan dirujuk.

Nilai kembali

Tidak ada

Keterangan

Dalam build yang dicentang, RxpTrackReference digunakan untuk melacak permintaan untuk mereferensikan struktur SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB, dan SRV_OPEN. Untuk build ritel, fungsi ini tidak melakukan apa pun.

Jika WMI diaktifkan, log operasi dereferensi ini 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 mereferensikan struktur yang dilewatkan (kenaikan 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 pertama-tama memanggil rutinitas RxpTrackReference yang sesuai untuk mencatat informasi diagnostik tentang permintaan sebelum memanggil rutinitas RxReference yang sesuai.

Untuk build ritel, fungsi ini tidak melakukan apa pun.