Required OAL Functions (Windows Embedded CE 6.0)

1/5/2010

The following table shows the required OAL functions. These functions are present in the OAL and are required by the kernel library Nk.lib.

Note

This is not an all-inclusive OAL function list. OEMs can implement additional functions to enhance platform support.

Programming element	Description
CacheErrorHandler	This function handles cache errors that occur on a MIPS platform.
FlushDCache	This function is deprecated and should never be used. Instead, use the OEMCacheRangeFlush function.
FlushICache	This function is deprecated and should never be used. Instead, use the OEMCacheRangeFlush function.
InitClock	Required. This function initializes the CPU clock and set the system tick interval frequency.
OEMARMCacheMode	This function sets the cache mode used to build the ARM CPU page tables.
OEMCacheRangeFlush	This functionflushes or invalidates a certain range of the cache or translation look-aside buffer (TLB). It is used by the kernel.
OEMClearDebugCommError	This function clears and initializes the serial communications port.
OEMDataAbortHandler	This function handles base-register updates and is specific to ARM processors, excluding StrongARM and XScale. It is called from the kernel when a data abort occurs.
OEMFlushCache	This function responds to a CacheSync function request. It is used by the kernel.
OEMGetExtensionDRAM	This function gets information about extension dynamic RAM (DRAM), if present on the device.
OEMGetRealTime	This function retrieves the time from the real-time clock. It is called by the kernel.
OEMIdle	This function places the CPU in the idle state when there are no threads ready to run. It is called by the kernel.
OEMInit	This function initializes all hardware interfaces for the target device. It is implemented by the OEM.
OEMInterruptDisable	This function disables the specified hardware interrupt.
OEMInterruptDone	This function signals completion of interrupt processing.
OEMInterruptEnable	This function performs any hardware operations necessary to enable the specified hardware interrupt.
OEMInterruptHandler	This function handles interrupts. It is called by the kernel when an interrupt occurs.
OEMInterruptHandlerFIQ	This function provides fast interrupt request (FIQ) support for the ARM microprocessor. It is implemented by the OEM.
OEMIoControl	This function provides a generic I/O control code (IOCTL) for OEM-supplied information.
OEMNMI	This function supports a nonmaskable interrupt. It is implemented by the OEM.
OEMNMIHandler	This function captures a nonmaskable interrupt (NMI). It is implemented by an OEM.
OEMPowerOff	This function places the CPU into a suspend state and is responsible for any final power-down state operations. It is invoked when the user presses the OFF button or when the Graphics, Windowing, and Events Subsystem (GWES) power-off timer signals that the CPU has timed out.
OEMSetAlarmTime	This function sets the real-time clock alarm. It is called by the kernel.
OEMSetRealTime	This function sets the real-time clock. It is called by the kernel.
pReadRegistryFromOEM	This function reads a registry file into RAM from persistent storage as defined by the OEM. Changing this global variable to point to an implementation of the ReadRegistryFromOEM function is optional.
SC_GetTickCount	This function retrieves the number of milliseconds that have elapsed since Windows Embedded CE was started. It is called from the OAL.
TLBClear	This function is deprecated and should never be used. Instead, use the OEMCacheRangeFlush function.

For information about the CPU dependencies for the required OAL functions, see CPU Dependencies for OAL Functions.

See Also

Reference

OAL Functions