RxpTrackReference 関数 (fcb.h)

[アーティクル]
10/10/2023

RxpTrackReference は、チェックされたビルド内のSRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB、およびSRV_OPEN構造体を参照する要求を追跡します。これらの参照要求のログには、ログシステムと WMI からアクセスできます。

構文

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

パラメーター

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構造体に対する参照要求。

FileName

[入力]このルーチンが呼び出されたソースファイルの名前。

Line

[入力]このルーチンが呼び出されたソースファイル内の行番号。

Instance

参照する構造体へのポインター。

戻り値

なし

解説

チェックビルドでは、 RxpTrackReference を使用して、SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB、およびSRV_OPEN構造体を参照する要求を追跡します。小売ビルドの場合、この関数は何も行いません。

WMI が有効になっている場合、これらの逆参照操作のログは、通知を要求したユーザーモード WMI コンポーネントに WMI イベントとして送信されます。遅延要求は、 _RxLog ルーチンを呼び出してログ記録が有効になっている場合に I/O エラーログエントリを記録することによって、RDBSS ログシステムにも記録されます。

このルーチンは、渡された構造体を実際には参照しないことに注意してください (構造体の参照カウントをインクリメントします)。

fcb.h では、このルーチンを呼び出すために推奨されるデバッグ用のマクロが多数定義されています。これらのマクロは、SRV_CALL、NET_ROOT、V_NET_ROOT、FOBX、FCB、およびSRV_OPEN構造体に対するファイル構造管理操作に使用される RxReference ルーチンまたは RxDereference ルーチンのラッパーを提供します。これらのマクロは、対応する RxpTrackReference ルーチンを呼び出して要求に関する診断情報をログに記録してから、対応する RxReference ルーチンを呼び出します。

小売ビルドの場合、この関数は何も行いません。