Macro CopyFromModeAligned (usermode_accessors.h)

La macro CopyFromModeAligned copie en toute sécurité les données de la mémoire en mode spécifié vers la mémoire du noyau, avec vérification de l’alignement.

Syntax

#define CopyFromModeAligned(Destination, Source, Length, Mode, Alignment)                           \
            do {                                                                                    \
                if ((Mode) != KernelMode) {                                                         \
                    ExProbeAlignment((Source), (Length), (Alignment));                              \
                }                                                                                   \
                CopyFromMode((Destination), (Source), (Length), (Mode));                            \
            } while (0)

Parameters

Destination

[out] Pointeur vers l’emplacement de mémoire du noyau où les données seront copiées.

Source

[in] Pointeur vers l’emplacement de mémoire à partir duquel copier les données.

Length

[in] Nombre d’octets à copier.

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.

Alignment

[in] Limite d’alignement que le pointeur source doit satisfaire.

Valeur de retour

None

Remarks

Cette macro offre un moyen sûr de copier des données du noyau ou de la mémoire en mode utilisateur vers la mémoire du noyau, avec le mécanisme de copie déterminé par le mode processeur spécifié et la vérification de l’alignement. Cela permet des opérations de mémoire flexibles qui peuvent s’adapter à différents contextes d’exécution tout en garantissant des exigences d’alignement appropriées.

Quand le mode est KernelMode :

• La macro effectue une copie volatile à l’aide de memory_order_relaxed sémantique.

• La macro n’est pas reconnue comme intrinsèque du compilateur afin que le compilateur n’optimise jamais l’appel (entièrement ou remplacez l’appel par une séquence d’instructions équivalente).

• Lorsque l’appel est retourné, les données ont été copiées de la source vers la destination. Les accès à la mémoire de cette macro à la source et à la destination ne sont effectués que dans la fonction (par exemple, le compilateur ne peut pas déplacer les accès à la mémoire hors de cette fonction).

• La macro peut accéder à des emplacements de mémoire plusieurs fois dans le cadre de son opération de copie.

• La macro ne prend pas en charge les opérations de copie lorsque la source et la destination se chevauchent.

La macro déclenche une exception structurée si l’opération de copie échoue, par exemple lorsque l’adresse source n’est pas valide pour le mode spécifié, n’est pas correctement alignée en fonction du paramètre Alignment ou est inaccessible.

Si vous copiez à partir d’une structure de taille fixe, vous devez utiliser ReadStructFromModeA align à la place pour éviter le risque de transmettre la taille incorrecte.

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).

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 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

CopyFromMode

CopyFromUser

CopyFromUserAligned

CopyFromModeNonTemporal

CopyToMode