WriteUnicodeStringToMode, fonction (usermode_accessors.h)

The WriteUnicodeStringToMode function safely writes a UNICODE_STRING structure to memory based on the specified processor mode.

Syntax

VOID WriteUnicodeStringToMode(
  UNICODE_STRING  *Destination,
  UNICODE_STRING  Value,
  KPROCESSOR_MODE Mode
);

Parameters

Destination

[out] A pointer to the memory location where the UNICODE_STRING structure will be written.

Value

[in] The UNICODE_STRING structure to write to the destination memory location.

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.

Return value

None

Remarks

This function provides a safe way to write a UNICODE_STRING structure to memory, with extra safety checks when accessing user-mode memory. 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

See also

WriteUnicodeStringToUser

ReadUnicodeStringFromMode