WriteUInt16ToUserRelease, fonction (usermode_accessors.h)

The WriteUInt16ToUserRelease function safely writes a UINT16 value to user-mode memory with release semantics.

Syntax

VOID WriteUInt16ToUserRelease(
  volatile UINT16 *Destination,
  UINT16          Value
);

Parameters

Destination

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

Value

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

Return value

None

Remarks

Cette fonction offre un moyen sûr d’écrire une valeur UINT16 en mémoire en mode utilisateur. Elle garantit que l’adresse fournie est une adresse en mode utilisateur avant de l’écrire. The release semantics ensure that preceding memory operations can't be reordered after this write operation.

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). The memory access is performed with memory_order_release semantics.

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

WriteUInt16ToUser

ReadUInt16FromUserAcquire