次の方法で共有


RxCreateNetFobx 関数 (fcb.h)

RxCreateNetFobx は、この FOBX を開いている FCB のメモリ内データ構造に新しいファイル オブジェクト拡張子 (FOBX) 構造体を割り当て、初期化し、挿入します。

構文

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

パラメーター

[out] RxContext

作成操作を記述するRX_CONTEXT構造体へのポインター。

[in] MrxSrvOpen

関連付けられているSRV_OPEN構造体へのポインター。

戻り値

RxCreateNetFobx は 、成功した場合は新しく割り当てられた FOBX データ構造へのポインター、または失敗した場合は NULL ポインターを返します。

注釈

ネットワーク ミニ リダイレクターは RxCreateNetFobx を呼び出して、正常な作成操作の最後に FOBX を作成する必要があります。

RxCreateNetFobx を呼び出す前に、FOBX 構造体に関連付けられている FCB を排他モードで取得する必要があります。

RxCreateNetFobx は、関連付けられた FCB 構造体の一部として割り当てられた FOBX が使用可能な場合に使用しようとします。 FCB で割り当てられた FOBX が使用できない場合、 RxCreateNetFobx は、関連付けられているSRV_OPEN構造体の一部として割り当てられた FOBX を使用しようとします (使用可能な場合)。 いずれの場合も、 RxCreateNetFobx は 既存の FOBX 構造体を初期化するだけで済み、メモリ割り当ては必要ありません。 関連付けられた FCB とSRV_OPEN構造体の両方の FOBX 構造体が使用できない場合、 RxCreateNetFobx は新しい FOBX 構造体を割り当てます。

関連付けられた FCB がページング ファイルの場合、 RxCreateNetFobx は 、新しい FOBX データ構造を作成するときに、ページ以外のプール メモリを割り当てます。 関連付けられた FCB がページング ファイルではない場合、 RxCreateNetFobx は 、新しい FOBX データ構造の作成時にページ プール メモリを割り当てます。

Windows では現在、リモート コンピューターにページング ファイルを設定することはできません。

成功すると、FOBX 構造体の次の FOBX メンバーが設定されます。

  • NodeReference メンバーは 1 に設定されています。
  • FobxSerialNumber メンバーは 0 に設定されています。
  • SrvOpen メンバーは、関連付けられているSRV_OPEN構造体に設定されます。
  • fOpenCountDecremented メンバーは FALSE に設定されます
  • Flags メンバーは、RX_CONTEXTからのパラメーターと、新しい FOBX を割り当てる必要があるかどうかに基づいて値に設定されます。
成功すると、SRV_OPEN構造体の参照カウントがインクリメントされ、関連付けられているV_NET_ROOT構造体の NumberOfFobxs メンバーがインクリメントされます。

要件

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

こちらもご覧ください

RX_CONTEXT

RxCreateNetFcb

RxCreateNetRoot

RxCreateSrvCall

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb