LoadDriver (Compact 2013)

3/28/2014

This function maps the specified executable module into the address space of the calling process. This function also prevents the code and data from being paged out.

Syntax

HINSTANCE LoadDriver(
  LPCWSTR lpszFileName
);

Parameters

  • lpszFileName
    [out] Pointer to a null-terminated string that names the executable module.

Return Value

A handle to the module indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

This function is different from the LoadLibrary function because the entire executable module is locked into memory and never pages out. Because the LoadDriver function has the same specification as LoadLibrary, it calls LoadLibrary to fulfill the request. To free the executable module and release the memory back to the system, use the FreeLibrary function.

Any code that needs to guarantee real-time performance should load the code with LoadDriver. All drivers loaded by the system load using LoadLibrary.

Requirements

Header

pkfuncs.h

Library

coredll.lib

See Also

Reference

Kernel Functions
FreeLibrary
LoadLibrary
LockPages