EngLoadModule function (winddi.h)

The EngLoadModule function loads the specified data module into system memory for reading.

Syntax

ENGAPI HANDLE EngLoadModule(
  [in] LPWSTR pwsz
);

Parameters

[in] pwsz

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

Return value

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

Remarks

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

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 writable module, the driver should call EngLoadModuleForWrite. 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

See also

EngFreeModule

EngLoadModuleForWrite

EngMapModule