Optional OAL Functions (Compact 2013)

10/16/2014

The following table shows the optional OEM adaptation layer (OAL) functions

Note

These functions are implemented by the OEM.

Function

Description

OEMCalcFSPages

Recalculates how much memory to allocate to the object store.

OEMEnumExtensionDRAM

Returns information about extension dynamic RAM (DRAM) if it is present on the device.

OEMGetOEMRamTable

Implemented by the OEM to return the OEMRamTable structure, which allows your platform to support more than 512 MB of physical memory.

OEMHaltSystem

Performs tasks the OEM considers necessary before the kernel halts the system.

OEMHandleVFPException

Handles a floating-point exception that is reported by vector floating point (VFP) hardware.

OEMIdleEx

Places the CPUs in the idle state when there are no threads ready to run.

OEMInitClock

Initializes the CPU clock after the OAL returns from the OEMPowerOff function.

OEMInitCoProcRegs

Initializes the platform-specific debug registers in the debug coprocessor.

OEMInitInterlockedFunctions

Initializes the interlocked function table for the OAL.

OEMIpiHandler

Handles platform-specific interprocessor interrupts.

OEMIsRom

Determines if a given address falls within a valid range of ROM addresses, and may be used to support ROM breakpoints.

OEMIsProcessorFeaturePresent

Provides information about whether the processor supports a specified feature.

OEMIsVFPFeaturePresent

Queries the OAL for information about VFP hardware.

OEMKDIoctl

Serves as the Platform Builder kernel debugger interface to the Kernel Debugger IOCTLs and is a prerequisite for support of the IOCTLs.

OEMMapW32Priority

Initializes a custom mapping of Win32 thread priorities to Windows Embedded Compact thread priorities.

OEMMpCpuPowerFunc

Changes the power state of a specific CPU in a multiprocessor platform.

OEMMpPerCPUInit

Performs tasks the OEM considers necessary to initialize each subordinate CPU in a multiprocessor platform.

OEMMpStartAllCpus

Runs on the master CPU and starts all subordinate CPUs in a multiprocessor platform.

OEMNotifyForceCleanBoot

Performs tasks the OEM considers necessary when the file system is identified as corrupted.

OEMNotifyIntrOccurs

Called when an interrupt occurs.

OEMNotifyReschedule

Performs tasks the OEM considers necessary when a new thread is ready to run.

OEMNotifyThreadExit

Performs tasks the OEM considers necessary when a thread exits.

OEMProfileTimerDisable

Clears and disables a profiler timer.

OEMProfileTimerEnable

Enables a profiler timer.

OEMQueryPerformanceCounter

Retrieves the current value of the high-resolution performance counter.

OEMQueryPerformanceFrequency

Retrieves the frequency of the high-resolution performance counter.

OEMReadRegistry

Reads a registry file into RAM from persistent storage as defined by the OEM.

OEMRefreshWatchDog

Refreshes the hardware watchdog timer.

OEMRestoreCoProcRegs

Restores the platform-specific debug registers when a thread switch occurs.

OEMRestoreVFPCtrlRegs

Restores the state of the extra implementation-specific VFP registers for the current thread.

OEMSaveCoProcRegs

Saves the platform-specific debug registers when a thread switch occurs.

OEMSaveVFPCtrlRegs

Saves the state of the extra implementation-specific VFP registers for the current thread.

OEMSendIpi

Sends an interprocessor interrupt.

OEMSetMemoryAttributes

Handles changes to memory attributes.

OEMUpdateReschedTime

Sets the next reschedule time in variable-tick timer implementations.

OEMVFPCoProcControl

Sends a command to the VFP hardware.

OEMWriteDebugLED

Outputs a byte to the destination device's specified LED port.

OEMWriteRegistry

Transfers registry data to persistent storage.

PFN_PTEUpdateBarrier

Notifies the CPU that the page table entry region of virtual memory has been modified.

OEMGetSnapshotRegions

Specifies OEM-specific regions of RAM to include in the memory snapshot taken by snapshot boot.

OEMCompressSnapshot

Compresses the snapshot image before the image is written to storage.

OEMPrepareSnapshot

Prepares enough storage to save the snapshot memory image.

OEMReadSnapshot

Reads from snapshot storage at the specified offset.

OEMSnapshotResume

Initializes the platform and re-initializes all CPU-specific hardware as if the system had just cold-booted.

OEMTakeCPUSnapshot

Saves all CPU registers, including control registers, that must be restored when booting from a snapshot.

OEMWriteSnapshot

Writes the snapshot image to nonvolatile storage.

See Also

Reference

OAL Functions