EngLoadImage macro (winddi.h)

The EngLoadImage function loads the specified executable image into kernel-mode memory.

Syntax

void EngLoadImage(
  [in]  filename
);

Parameters

[in] filename

Pointer to a null-terminated string that names the file containing the executable image to be loaded.

Return value

None

Remarks

A driver can use EngLoadImage to map an executable image into kernel-mode memory. For example, a printer driver can call EngLoadImage to load a minidriver.

EngLoadImage requires that the image file to be loaded have a .dll suffix. The driver must include this suffix in the pwszDriver string.

To execute a section of code within the loaded image, the driver should obtain the function address from EngFindImageProcAddress.

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

Drivers that need to load a module as data only should call EngLoadModule or EngLoadModuleForWrite 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

See also

EngLoadModule

EngLoadModuleForWrite

EngUnloadImage