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.
La macro WriteStructToMode écrit en toute sécurité une structure en mémoire en fonction du mode processeur spécifié.
Syntax
void WriteStructToMode(
Destination,
Source,
Mode
);
Parameters
Destination
[out] Pointeur vers l’emplacement de mémoire où la structure sera écrite.
Source
[in] Pointeur vers la structure à écrire dans l’emplacement de la mémoire de destination.
Mode
[in] Mode processeur qui détermine la façon dont l’accès à la mémoire est effectué. Le mode peut être l’une des valeurs suivantes.
| Value | Meaning |
|---|---|
| KernelMode | La destination pointe vers la mémoire en mode noyau. La macro effectue une écriture dans l’adresse spécifiée avec memory_order_relaxed sémantique. Pour plus d’informations, consultez les remarques. |
| UserMode | La destination pointe vers la mémoire en mode utilisateur. La macro déclenche une exception si destination ne pointe pas vers la mémoire en mode utilisateur ; sinon, il effectue une écriture dans l’adresse spécifiée avec memory_order_relaxed sémantique. Pour plus d’informations, consultez les remarques. |
Return value
None
Remarks
Cette macro offre un moyen sûr d’écrire une structure 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é.
La macro valide que la source et la destination pointent vers des types compatibles et déterminent automatiquement la taille de la structure pour l’opération de copie.
Cette macro 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 valide ou est inaccessible pour le mode processeur spécifié.
Cette macro 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 macro soit appelée ou après le retour de la macro (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 macro 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 macro à 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
| Requirement | Value |
|---|---|
| Client minimum requis | See Remarks |
| Header | usermode_accessors.h |
| Library | umaccess.lib |
| IRQL | Inférieur ou égal à APC_LEVEL |