RxNewMapUserBuffer 関数

RxNewMapUserBuffer は、低 I/O に使用されるユーザー バッファー アドレスを返します。

構文

PVOID RxNewMapUserBuffer(
  _In_ PRX_CONTEXT RxContext
);

パラメーター

RxContext [in]
この要求の RX_CONTEXT 構造体へのポインター。

戻り値

RxNewMapUserBuffer は、成功した場合はマップされたアドレス ポインターを 返し、失敗した場合は NULL を返します。

解説

MDL が存在する場合は、MDL がユーザー バッファーを記述し、MDL のシステム アドレスが RxNewMapUserBuffer によって返されることを前提とします。 それ以外の場合、ユーザー バッファーは RxNewMapUserBuffer によって直接返されます。

RxContext 変数の CurrentIrp->MdlAddress メンバーが NULL の場合、RxNewMapUserBuffer ルーチンはチェックし、その場合は RxContext 変数の CurrentIrp->UserBuffer メンバーを返します。 CurrentIrp->MdlAddress メンバーが NULL でない場合、RxNewMapUserBuffer は MmGetSystemAddressForMdlSafe を呼び出して IRP から MDL を返します。

RxNewMapUserBuffer ルーチンは、Windows XP および Windows 2000 でのみ使用できることにご注意ください。

要件

対象プラットフォーム	デスクトップ
バージョン	RxNewMapUserBuffer ルーチンは、Windows XP および Windows 2000 でのみ使用できます。
ヘッダー	Rxprocs.h (Rxcontx.h または Rxprocs.h を含む)
IRQL	<= APC_LEVEL

関連項目

MmGetSystemAddressForMdlSafe

RxLowIoCompletion

RxLowIoGetBufferAddress

RxMapSystemBuffer

RX_CONTEXT