MoveToUserFromUser, fonction (usermode_accessors.h)

The MoveToUserFromUser function safely moves data from user-mode memory to user-mode memory, supporting overlapping memory regions.

Syntax

VOID MoveToUserFromUser(
  volatile VOID       *Destination,
  volatile const VOID *Source,
  SIZE_T              Length
);

Parameters

Destination

[out] Pointeur vers l’adresse de départ de l’emplacement de mémoire en mode utilisateur où les données seront copiées.

Source

[in] Pointeur vers l’adresse de départ de l’emplacement de mémoire en mode utilisateur à partir duquel copier les données.

Length

[in] Nombre d’octets à déplacer.

Return value

None

Remarks

Cette fonction offre un moyen sûr de déplacer des données de la mémoire en mode utilisateur vers la mémoire en mode utilisateur avec prise en charge des régions de mémoire qui se chevauchent.

La fonction a les propriétés suivantes :

• The function performs a move using memory_order_relaxed semantics.

• La fonction n’est pas reconnue comme intrinsèque du compilateur afin que le compilateur n’optimise jamais l’appel (entièrement ou remplacez l’appel par une séquence d’instructions équivalente).

• When the call returns, the data has been copied from Source to Destination. This function's memory accesses to the Source and Destination will only be performed within the function (for example, the compiler can't move memory accesses out of this function).

• La fonction peut effectuer des accès non alignés si la plateforme l’autorise.

• La fonction peut accéder à des emplacements de mémoire plusieurs fois dans le cadre de son opération de remplissage.

La fonction valide que les deux pointeurs font référence à la mémoire en mode utilisateur et déclenche une exception structurée si l’opération de déplacement échoue, par exemple lorsque les adresses source ou de destination ne sont pas valides en mode utilisateur ou sont inaccessibles.

Cette fonction fonctionne sur toutes les versions de Windows, pas seulement sur la dernière version. You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. Toutefois, le pilote résultant s’exécutera correctement sur les versions antérieures de Windows.

Requirements

See also

CopyToUserFromUser

CopyToUser

CopyFromUser