EngLoadModuleForWrite function (winddi.h)

Article
02/22/2024

The EngLoadModuleForWrite function loads the specified executable module into system memory for writing.

Syntax

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

Parameters

[in] pwsz

Pointer to a null-terminated string that contains the name of the file to be loaded.

[in] cjSizeOfModule

Specifies the size, in bytes, of the module to be loaded.

Return value

If EngLoadModuleForWrite succeeds, the return value is a handle to the module that was loaded. Otherwise, NULL is returned.

Remarks

EngLoadModuleForWrite loads a data file into system memory with write permission. To access the loaded module, the driver should call EngMapModule with the handle returned by this function.

EndLoadModuleForWrite loads the file into memory that is the same size as the file when cjSizeOfModule is zero. If cjSizeOfModule is greater than zero, GDI extends or truncates the file to be exactly cjSizeOfModule bytes in size before loading it. No assumptions should be made about the contents of memory that extend beyond the file when cjSizeOfModule is greater than the file's original size.

The file identified by pwsz must be located in the %SystemRoot%\System32 directory or within a directory found in the directory hierarchy under %SystemRoot%\System32.

To load a module with read-only permissions, the driver should call EngLoadModule. Drivers that need to load an image as executable code should call EngLoadImage instead of this function.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys