Freigeben über


RxNewMapUserBuffer-Funktion

RxNewMapUserBuffer gibt die Benutzerpufferadresse zurück, die für niedrige E/A-Vorgänge verwendet wird.

Syntax

PVOID RxNewMapUserBuffer(
  _In_ PRX_CONTEXT RxContext
);

Parameter

RxContext [in]
Ein Zeiger auf die RX_CONTEXT-Struktur für diese Anforderung.

Rückgabewert

RxNewMapUserBuffer gibt einen zugeordneten Adresszeiger bei Erfolg oder NULL bei Fehler zurück.

Hinweise

Wenn eine MDL vorhanden ist, wird davon ausgegangen, dass die MDL den Benutzerpuffer beschreibt und die Systemadresse für die MDL von RxNewMapUserBuffer zurückgegeben wird. Andernfalls wird der Benutzerpuffer direkt von RxNewMapUserBuffer zurückgegeben.

Die RxNewMapUserBuffer-Routine überprüft, ob das CurrentIrp-MdlAddress-Member der RxContext-Variable> NULL ist, und gibt den CurrentIrp-UserBuffer-Member der RxContext-Variable> zurück, wenn dies der Fall ist. Wenn der CurrentIrp-MdlAddress-Member> nicht NULL ist, ruft RxNewMapUserBufferMmGetSystemAddressForMdlSafe auf, um die MDL vom IRP zurückzugeben.

Beachten Sie, dass die RxNewMapUserBuffer-Routine nur unter Windows XP und Windows 2000 verfügbar ist.

Anforderungen

Zielplattform

Desktop

Version

Die RxNewMapUserBuffer-Routine ist nur unter Windows XP und Windows 2000 verfügbar.

Header

Rxprocs.h (einschließlich Rxcontx.h oder Rxprocs.h)

IRQL

<= APC_LEVEL

Weitere Informationen

MmGetSystemAddressForMdlSafe

RxLowIoCompletion

RxLowIoGetBufferAddress

RxMapSystemBuffer

RX_CONTEXT