ReadIntPtrFromUserAcquire, fonction (usermode_accessors.h)

The ReadIntPtrFromUserAcquire function safely reads an INT_PTR value from user-mode memory with acquire semantics.

Syntax

INT_PTR ReadIntPtrFromUserAcquire(
  const volatile INT_PTR *Source
);

Parameters

Source

[in] Pointeur vers l’emplacement de mémoire en mode utilisateur à partir duquel lire la valeur INT_PTR.

Return value

ReadIntPtrFromUserAcquire returns the INT_PTR value read from the specified user-mode memory address.

Remarks

Cette fonction offre un moyen sûr de lire une valeur INT_PTR à partir de la mémoire en mode utilisateur. Elle garantit que l’adresse fournie est une adresse en mode utilisateur avant de la lire. The acquire semantics ensure that subsequent memory operations can't be reordered before this read 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 source 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_acquire 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

ReadIntPtrFromUser

WriteIntPtrToUserRelease