RxCreateNetFcb 関数 (fcb.h)

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

RxCreateNetFCB は、この FCB を開いているV_NET_ROOTのメモリ内データ構造に新しい FCB 構造体を割り当て、初期化し、挿入します。割り当てられた構造体には、SRV_OPENと FOBX 構造体の領域があります。

構文

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

パラメーター

[in] RxContext

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

[in] Irp

このRX_CONTEXT構造体によってカプセル化された IRP へのポインター。

[in] VNetRoot

この FCB が開かれているV_NET_ROOT構造体へのポインター。

[in] Name

FCB の名前。 V_NET_ROOTには、ここで先頭に付ける名前プレフィックスが含まれている場合があります。

戻り値

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

注釈

RxCreateNetFCB ルーチンは、通常、ネットワークミニリダイレクタードライバーによって直接呼び出されません。 RDBSS は、IRP_MJ_CREATEに対して I/O 要求パケットを受信し、FCB 構造体を作成する必要がある場合に、このルーチンを内部的に呼び出します。この IRP は、通常、ネットワーク共有でファイル作成操作を要求するユーザーモードアプリケーションに応答して RDBSS によって受信されます。また、別のカーネルドライバーがこのような IRP を発行することもできます。

作成する FCB がページングファイルの場合、 RxCreateNetFCB は、新しい FCB データ構造を作成するときに非ページプールメモリを割り当て、FCB の FcbState メンバーに次のフラグを設定します。

作成する FCB がページングファイルではない場合、 RxCreateNetFCB は、新しい FCB データ構造の作成時にページプールメモリを割り当てます。

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

RX_CONTEXTの Create.Flags メンバーに RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH フラグが設定されている場合、 FCB の FcbState メンバーには FCB_STATE_ADDEDBACKSLASH フラグが設定されています。