RxpTrackReference 関数 (fcb.h)

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

構文

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

パラメーター

TraceType

[in]追跡する参照要求の種類を決定する値。 この値には、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

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

Line

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

Instance

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

戻り値

何一つ

備考

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

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

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

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

リテール ビルドの場合、この関数は何も行いません。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー fcb.h (Fcb.h を含む)
IRQL <= APC_LEVEL

関連項目

RxAssert の

RxDbgBreakPoint の

RxDereference の

RxReference の

RxpTrackDereference の

_RxLog

  • Last updated on