Optional OAL Variables
The following table shows the optional OAL variables with a description of the purpose of each.
| Programming element | Description |
|---|---|
| cbNKCoProcRegSize | This global variable describes the size of the memory allocation, in bytes, needed for the OEM to save/restore coprocessor registers. |
| CEProcessorType | This global variable is used by the kernel to assign the microprocessor type to the dwProcessorType member of SYSTEM_INFO. |
| curridlehigh | This global variable contains the high DWORD of the 64-bit idle time, in milliseconds, and is used to support GetIdleTime. |
| curridlelow | This global variable contains the low DWORD of the 64-bit idle time, in milliseconds, and is used to support GetIdleTime. |
| dwDefaultThreadQuantum | This variable sets the default thread quantum of all threads. |
| dwNKAlarmResolutionMSec | This variable allows the OEM to specify the resolution of the kernel alarm timer to 1 second. |
| dwNKMaxPrioNoScav | This variable defines the highest priority for a thread that should not incur stack space recovery. |
| dwOEMCleanPages | This variable is set to signal the kernel how much memory should be zeroed to enable the device to boot. |
| fNKSaveCoProcReg | This global variable is used as a flag to tell the kernel when the save/restore of coprocessors registers is performed. |
| idleconv | This global variable is a translation constant in one-millisecond units and is used to support GetIdleTime. |
| DiffMSec | This global variable indicates the number of milliseconds since the last time that the scheduler examined the sleep queue. This variable is obsolete for Windows CE .NET 4.0 and later. |
| dwCeLogLargeBuf | This global variable is used by the OEM to adjust the size of the main logging buffer. |
| dwCeLogSmallBuf | This global variable is used by the OEM to adjust the size of the secondary logging buffer. |
| dwCeLogTLBMiss | This global variable specifies how many translation look-aside buffer (TLB) misses have occurred for the last thread that was running. |
| dwNKCoProcEnableBits | This variable is specific to MIPS processors and allows an OEM to identify additional coprocessors that should be enabled and disabled when required. |
| dwOEMPTPoolSize | This variable defines the page table pool size in pages. This variable is no longer used as of Windows CE .NET 4.2. The page table is now dynamically–allocated as needed. |
| dwPartialDiffMSec | This variable is used in conjunction with DiffMSec to indicate the amount of time that has passed since the last time the scheduler has examined the sleep queue. This variable is obsolete. |
| dwPreempt | This global variable specifies the number of milliseconds until a thread can be preempted. This variable is obsolete. |
| dwSleepMin | This global variable specifies the number of milliseconds until the first sleep, if any, expires, requiring a reschedule. This variable is obsolete. |
| fUseIterations | If OEMEthGetSecs has been designed to work with interrupts off, this flag should be set to FALSE. Otherwise, the flag should be declared in OEMInit and set to TRUE. This variable is obsolete. |
| lpReadDebugByteFunc | This global variable is defined in the kernel and points to the OEMReadDebugByte function by default. |
| lpWriteDebugByteFunc | This global variable is defined in the kernel and points to the OEMWriteDebugByte function by default. |
| lpWriteDebugStringFunc | This global variable is defined in the kernel and points to the OEMWriteDebugString function by default. |
| MainMemoryEndAddress | This global variable specifies the next available address following the first available contiguous block of memory |
| OEMMemoryMap | This global variable array provides the virtual-to-physical mapping. This variable is obsolete. Use OEMAddressTable instead. |
| OEMTLBSize | This variable is declared by the OEM and defines how many TLB entries are supported. |
| pLogProcessCreate | This global variable is optional and points to LogProcessCreate, an optional OAL function used to log process creation. |
| pLogProcessDelete | This global variable is optional and points to LogProcessDelete, an optional OAL function used to log process deletion. |
| pLogThreadCreate | This global variable is optional and points to LogThreadCreate, an optional OAL function used to log thread creation. |
| pLogThreadDelete | This global variable is optional and points to LogThreadDelete, an optional OAL function used to log thread deletion. |
| pLogThreadSwitch | This global variable is optional and points to LogThreadSwitch, an optional OAL function used to log thread switches. |
| pNKEnumExtensionDRAM | This global variable is a kernel global function pointer that is used by the kernel to enumerate multiple memory sections. |
| pOEMCertifyModule | This global variable is optional and points to the OEMCertifyModule function, if defined. |
| pOEMCertifyModuleInit | This global variable is optional and points to the OEMCertifyModuleInit function, if defined. |
| pOEMLoadInit | This global variable is optional and points to the OEMCertifyModuleInit function, if defined. |
| pOEMLoadModule | This global variable is optional and points to the OEMCertifyModule function, if defined. |
| pReadRegistryFromOEM | This global variable is optional and points to the ReadRegistryFromOEM function, if defined. |
| pWriteDebugLED | This variable can be set by the OEM during OEMInit time to write debug output to an LED. |
| pWriteRegistryToOEM | This global variable is optional and points to the WriteRegistryToOEM function, if defined. |
See Also
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.