Macro ReadStructFromModeAligned (usermode_accessors.h)

La macro ReadStructFromModeAligned lit en toute sécurité une structure à partir de la mémoire en fonction du mode processeur spécifié avec validation d’alignement.

Syntax

void ReadStructFromModeAligned(
  Destination,
  Source,
  Mode,
  Alignment
);

Parameters

Destination

[out] Pointeur vers la structure qui reçoit les données lues à partir de la mémoire.

Source

[in] Pointeur vers l’emplacement de mémoire à partir duquel lire la structure.

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] Alignement requis pour l’adresse source, en octets.

Return value

None

Remarks

Cette macro offre un moyen sûr de lire une structure à partir de la mémoire, avec des contrôles de sécurité supplémentaires lors de l’accès à la mémoire en mode utilisateur et à l’application de l’alignement. Elle garantit que l’adresse fournie est valide et accessible en fonction du mode processeur spécifié et répond aux exigences d’alignement spécifiées lors de l’accès à la mémoire en mode utilisateur.

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 applique l’alignement en vérifiant que l’adresse source répond à l’exigence d’alignement spécifiée lors de l’accès à la mémoire en mode utilisateur. Cela permet d’éviter les pénalités de performances et les erreurs matérielles potentielles qui peuvent se produire lors de l’accès à des structures de données mal alignées.

Elle génère une exception structurée si l’accès à la mémoire échoue, par exemple lorsque l’adresse source n’est pas valide ou n’est pas inaccessible pour le mode processeur spécifié, ou ne répond pas aux exigences d’alignement.

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

See also

ReadStructFromMode

ReadStructFromUserAligned

ReadStructFromModeHelper

WriteStructToModeAligned