Fonction RxNewMapUserBuffer

Article
02/02/2024

RxNewMapUserBuffer retourne l’adresse de mémoire tampon de l’utilisateur utilisée pour les E/S faibles.

Syntaxe

PVOID RxNewMapUserBuffer(
  _In_ PRX_CONTEXT RxContext
);

Paramètres

RxContext [in]
Pointeur vers la structure RX_CONTEXT pour cette requête.

Valeur retournée

RxNewMapUserBuffer retourne un pointeur d’adresse mappé en cas de réussite ou NULL en cas d’échec.

Remarques

S’il existe une MDL, l’hypothèse est que la MDL décrit la mémoire tampon de l’utilisateur et que l’adresse système de la MDL est retournée par RxNewMapUserBuffer. Sinon, la mémoire tampon utilisateur est retournée directement par RxNewMapUserBuffer.

La routine RxNewMapUserBuffer vérifie si le membre CurrentIrp-MdlAddress> de la variable RxContext a la valeur NULL et retourne le membre CurrentIrp-UserBuffer> de la variable RxContext lorsque c’est le cas. Si le membre CurrentIrp-MdlAddress> n’est pas NULL, RxNewMapUserBuffer appelle MmGetSystemAddressForMdlSafe pour renvoyer la MDL à partir de l’IRP.

Notez que la routine RxNewMapUserBuffer est uniquement disponible sur Windows XP et Windows 2000.

Configuration requise

Plateforme cible	Desktop (Expérience utilisateur)
Version	La routine RxNewMapUserBuffer est disponible uniquement sur Windows XP et Windows 2000.
En-tête	Rxprocs.h (inclure Rxcontx.h ou Rxprocs.h)
IRQL	<= APC_LEVEL