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

See also

EngFreeModule

EngLoadModuleForWrite

EngMapModule