Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
The WriteLongPtrToMode function safely writes a LONG_PTR value to memory based on the specified processor mode.
Syntax
VOID WriteLongPtrToMode(
LONG_PTR *Destination,
LONG_PTR Value,
KPROCESSOR_MODE Mode
);
Parameters
Destination
[out] Pointeur vers l’emplacement de mémoire où la valeur LONG_PTR sera écrite.
Value
[in] Valeur LONG_PTR à écrire dans l’emplacement de mémoire de destination.
Mode
[in] Mode processeur qui détermine la façon dont l’accès à la mémoire est effectué. Mode can be one of the following values.
| Value | Meaning |
|---|---|
| KernelMode | Destination points to kernel-mode memory. The function performs a write to the specified address with memory_order_relaxed semantics. Pour plus d’informations, consultez les remarques. |
| UserMode | Destination points to user-mode memory. The function raises an exception if Destination doesn't point to user-mode memory; otherwise it performs a write to the specified address with memory_order_relaxed semantics. Pour plus d’informations, consultez les remarques. |
Return value
None
Remarks
Cette fonction offre un moyen sûr d’écrire une valeur LONG_PTR en mémoire, avec des contrôles de sécurité supplémentaires lors de l’accès à la mémoire en mode utilisateur. Elle garantit que l’adresse fournie est valide et accessible en fonction du mode processeur spécifié.
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 est inaccessible ou n’est pas valide pour le mode spécifié.
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_relaxed 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
| Requirement | Value |
|---|---|
| Client minimum requis | See Remarks |
| Header | usermode_accessors.h |
| Library | umaccess.lib |
| IRQL | Inférieur ou égal à APC_LEVEL |