RxNewMapUserBuffer 函数

RxNewMapUserBuffer 返回用于低 I/O 的用户缓冲区地址。

语法

PVOID RxNewMapUserBuffer(
  _In_ PRX_CONTEXT RxContext
);

参数

RxContext [in]
指向此请求的RX_CONTEXT结构的指针。

返回值

RxNewMapUserBuffer 在成功时返回映射的地址指针,在失败时返回 NULL

注解

如果存在 MDL,则假设 MDL 描述用户缓冲区,并且 MDL 的系统地址由 RxNewMapUserBuffer 返回。 否则,用户缓冲区由 RxNewMapUserBuffer 直接返回。

RxNewMapUserBuffer 例程检查 RxContext 变量的 CurrentIrp-MdlAddress > 成员是否为 NULL,并在出现这种情况时返回 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