RxpTrackDereference 関数 (fcb.h)

[アーティクル]
08/07/2023

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 ルーチンを呼び出す前に、要求に関する診断情報をログに記録します。