Optional OAL Functions (Windows Embedded CE 6.0)
1/5/2010
The following table shows the optional OAL functions.
| Programming element | Description |
|---|---|
Streams the bytes of a module for certification. It is called from the OEMCertifyModule function. |
|
Returns the final certification status of a file and any data embedded in the signature. |
|
Begins verifying a signature on a module to certify the module. |
|
Returns a value that references a particular instance of the ISR. It is implemented by an interrupt service routine (ISR). |
|
Frees the instance entry and is called when an installable ISR is unloaded using the FreeIntChainHandler function. |
|
Unloads an existing interrupt handler. |
|
Enables a communication path from the interrupt service thread (IST) to the ISR. It exported by the installable ISR DLL. |
|
Allocates memory that can be shared between the ISR and IST. |
|
Frees memory that is allocated by the KLibAllocShareMem function. |
|
Installs an ISR to handle a particular interrupt. It is called by a driver. |
|
Halts the system when a non-recoverable error is encountered. It is called when the kernel is about to halt the system. |
|
Determines which chained, or shared, interrupt device triggered an IRQ event. |
|
Creates a static virtual memory address that maps to a physical address. |
|
Forces the OS to boot from a clean file system. |
|
Enables the OS loader to pass the module code, for example, .dll, .exe, and .ocx, to the OEM to verify that a module can be safely run on the system. |
|
Enables the OS loader to notify the OEM that a new module is being loaded. |
|
Initializes the fInterruptWakeup array to determine whether a wake event has occurred since the execution of this function. |
|
Returns information about extension DRAM, if present on the device. |
|
No longer required, as of Windows CE .NET 4.2. For information about new debug communication settings, see the KITLTRANSPORT structure. |
|
No longer required. For information about new debug communication settings, see the KITLTRANSPORT structure. |
|
Determines the lowest-valued wake event that has occurred since a call to the OEMClearIntSources function. It uses the SYSINTR or SYSWAKE logical interrupts to do this. |
|
Helps implement the IOCTL_HAL_REQUEST_IRQ IOCTL in the OEMIoControl routine. |
|
Returns a wake event that has occurred since a call to the OEMPowerOff function. |
|
Handles a floating-point exception reported by vector floating point (VFP) hardware. |
|
Along with the set of enabled wake sources, determines if a wake event occurred. It indicates the occurrence of a specified SYSINTR. |
|
Initializes the debug registers. It is called by the kernel when a thread is created. |
|
Catches interrupts. It is called when an interrupt occurs. |
|
Supports requests from the kernel debugger. It is implemented by the OEM. |
|
Determines if a given address range falls within a valid range of ROM addresses, and may be used to support ROM breakpoints. |
|
Handles the initialization routines used by the kernel's suspend code. |
|
Catches thread switching. It is called when the new thread is ready to run. |
|
Resets wake event sources. |
|
Restores the platform specific debug registers when a thread switch occurs. It is called by the kernel. |
|
Restores the state of the extra implementation defined VFP registers for the current thread. |
|
Saves the platform-specific debug registers when a thread switch occurs. It is called by the kernel. |
|
Saves the state of the extra FPU registers for the current thread. It is called by the kernel. |
|
Sets wake event sources. |
|
Translates a non-shareable IRQ into a SYSINTR or into the last shared IRQ that an installable ISR does not contain. |
|
Maps a SYSINTR to its corresponding IRQ. |
|
Sends a byte to the target device's specified LED port. |
|
Can be used to change the DrWatsonClear functionality. |
|
Can be used to change the DrWatsonFlush functionality. |
|
Can be used to change the DrWatsonReadData functionality. |
|
Can be used to change the DrWatsonWriteData functionality. |
|
Refreshes the hardware watchdog. It is called by the kernel. |
|
Optional. Points to the OEMIntrOccurs function, if defined. |
|
Optional. Points to the OEMReschedule function, if defined. |
|
Supports changes to memory attributes. It is initialized to NULL. OEMs can initialize this function. |
|
Enumerates multiple memory sections. It is a kernel global function pointer that is used by the kernel. |
|
Forces a cold boot of the object store. It is called by Filesys.exe when a cold boot is about to occur. |
|
Recalculates how much memory should be allocated to the object store. It is called in the OAL by the kernel to |
|
Points to the IsProcessorFeaturePresent function, if defined. |
|
Optional. Points to the OEMCertifyModuleInit function, if defined. |
|
Optional. Points to the OEMCertifyModule function, if defined. |
|
Points to the function that reprograms the system timer. |
|
Optional. Points to the OEM implementation of the OEMQueryPerformanceCounter function. It should be set for platforms that provide timer functions with higher granularity than GetTickCount. |
|
Optional. Points to the OEM implementation of the OEMQueryPerformanceFrequency function. It should be set for platforms that provide timer functions with higher granularity than GetTickCount. |
|
Writes debug output to an LED. It can be set by the OEM during OEMInit time. |
|
Optional. Points to the WriteRegistryToOEM function, if defined. |
|
Reads a registry file into RAM from persistent storage as defined by the OEM. |
|
Transfers registry data to persistent storage. It is called by the operating system. |