LoadDriver

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Kernel Functions

Other Resources

FreeLibrary
LoadLibrary
Privileged APIs
Privileged APIs