FillUserMemory, fonction (usermode_accessors.h)

The FillUserMemory function fills a user-mode memory region with a specified byte value.

Syntax

VOID FillUserMemory(
  volatile VOID *Destination,
  SIZE_T        Length,
  UCHAR         Fill
);

Parameters

Destination

[out] Pointeur vers l’adresse de départ du bloc de mémoire à remplir.

Length

[in] The number of bytes to fill with the Fill value.

Fill

[in] The byte value used to fill the first Length bytes of Destination.

Return value

None

Remarks

Cette fonction offre un moyen sûr de remplir une région de mémoire en mode utilisateur avec une valeur d’octet spécifiée. Cela permet d’effectuer des opérations de mémoire flexibles lorsque le code en mode noyau doit initialiser les mémoires tampons en mode utilisateur.

La fonction a les propriétés suivantes :

• The function performs a fill using memory_order_relaxed semantics.

• La fonction 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).

• When the call returns, the buffer has been overwritten with the specified Fill value. This function's memory accesses to the Destination will only be performed within the function (for example, the compiler can't move memory accesses out of this function).

• La fonction peut effectuer des accès à la mémoire non alignés si la plateforme l’autorise.

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

La fonction déclenche une exception structurée si l’opération de remplissage échoue, par exemple lorsque l’adresse de destination n’est pas une adresse en mode utilisateur valide ou est inaccessible.

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

FillModeMemory

SetUserMemory

ZeroUserMemory

CopyToUser