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 を割り当てる必要があるかどうかに基づいて値に設定されます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | fcb.h (Rxcontx.h、Mrxfcb.h、Fcb.h を含む) |
IRQL | <= APC_LEVEL |