Fonction EngLoadModuleForWrite (winddi.h)

Article
08/27/2023

La fonction EngLoadModuleForWrite charge le module exécutable spécifié dans la mémoire système pour l’écriture.

Syntaxe

ENGAPI HANDLE EngLoadModuleForWrite(
  [in] LPWSTR pwsz,
  [in] ULONG  cjSizeOfModule
);

Paramètres

[in] pwsz

Pointeur vers une chaîne terminée par null qui contient le nom du fichier à charger.

[in] cjSizeOfModule

Spécifie la taille, en octets, du module à charger.

Valeur retournée

Si EngLoadModuleForWrite réussit, la valeur de retour est un handle pour le module qui a été chargé. Sinon, la valeur NULL est retournée.

Remarques

EngLoadModuleForWrite charge un fichier de données dans la mémoire système avec l’autorisation d’écriture. Pour accéder au module chargé, le pilote doit appeler EngMapModule avec le handle retourné par cette fonction.

EndLoadModuleForWrite charge le fichier en mémoire de la même taille que le fichier lorsque cjSizeOfModule est égal à zéro. Si cjSizeOfModule est supérieur à zéro, GDI étend ou tronque le fichier pour qu’il soit exactement de taille cjSizeOfModule avant de le charger. Aucune hypothèse ne doit être faite concernant le contenu de la mémoire qui s’étend au-delà du fichier lorsque cjSizeOfModule est supérieur à la taille d’origine du fichier.

Le fichier identifié par pwsz doit se trouver dans le répertoire %SystemRoot%\System32 ou dans un répertoire situé dans la hiérarchie des répertoires sous %SystemRoot%\System32.

Pour charger un module avec des autorisations en lecture seule, le pilote doit appeler EngLoadModule. Les pilotes qui doivent charger une image en tant que code exécutable doivent appeler EngLoadImage au lieu de cette fonction.

Configuration requise


Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

Partager via