WriteCharToUser, fonction (usermode_accessors.h)

La fonction WriteCharToUser écrit en toute sécurité une valeur CHAR dans la mémoire en mode utilisateur.

Syntax

VOID WriteCharToUser(
  volatile CHAR *Destination,
  CHAR          Value
);

Parameters

Destination

[out] Pointeur vers l’emplacement de mémoire en mode utilisateur où la valeur CHAR sera écrite.

Value

[in] Valeur CHAR à écrire dans l’emplacement de mémoire de destination.

Valeur retournée

None

Remarks

Cette fonction offre un moyen sûr d’écrire une valeur CHAR en mémoire en mode utilisateur. Elle garantit que l’adresse fournie est une adresse en mode utilisateur avant de l’écrire.

Cette fonction n’applique pas l’alignement.

Elle déclenche une exception structurée si l’accès à la mémoire échoue, par exemple lorsque l’adresse de destination n’est pas une adresse en mode utilisateur ou est inaccessible.

Cette fonction n’est jamais optimisée par le compilateur, ni le compilateur crée-t-il des accès supplémentaires à cet emplacement de mémoire avant que la fonction soit appelée ou après le retour de la fonction (sauf si le code source effectue explicitement ces accès). L’accès à la mémoire est effectué avec memory_order_relaxed sémantique.

Cette fonction fonctionne sur toutes les versions de Windows, pas seulement sur la dernière version. Vous devez utiliser la dernière clé WDK pour obtenir la déclaration de fonction à partir de l’en-tête usermode_accessors.h . Vous avez également besoin de la bibliothèque (umaccess.lib) à partir de la dernière clé WDK. Toutefois, le pilote résultant s’exécutera correctement sur les versions antérieures de Windows.

Requirements

Voir aussi

ReadCharFromUser

WriteCharToMode