次の方法で共有


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 を 返します。

注釈

チェックされたビルドでは、 RxpTrackDereference を使用して、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 ルーチンのラッパーを提供します。 これらのマクロは、対応する RxpTrackDereference ルーチンを呼び出して、対応する RxDereference ルーチンを呼び出す前に、要求に関する診断情報をログに記録します。

要件

要件
対象プラットフォーム デスクトップ
Header fcb.h (Fcb.h を含む)
IRQL <= APC_LEVEL

こちらもご覧ください

RxAssert

RxDbgBreakPoint

RxDereference

RxReference

RxpTrackReference

_RxLog