pNKEnumExtensionDRAM (Windows Embedded CE 6.0)

1/5/2010

This function is a kernel global function pointer used by the kernel to enumerate multiple memory sections indicated by the OEM. The kernel calls this function to determine if additional memory is present.

Syntax

DWORD (*pNKEnumExtensionDRAM)(
  PMEMORY_SECTION pMemSections,
  DWORD cMemSections
);

Parameters

• pMemSections
  [in] Pointer to an array of MEMORY_SECTION structures containing the extended memory sections.

• cMemSections
  [in] Size of the array specified by pMemSections. This value represents the maximum number of extended memory sections that can be reported to the kernel.

Return Value

Returns the number of extended memory sections written to the array specified by pMemSections.

Remarks

During OEMInit, the OEM must initialize pNKEnumExtensionDRAM to point to an OEM-defined OEMEnumExtensionDRAM function.

The kernel checks pNKEnumExtensionDRAM during boot. If the pointer is NULL (default), the kernel will call OEMGetExtensionDRAM. If the pointer is set, the kernel will not call OEMGetExtensionDRAM.

Example

The following example shows an OEM implementation of pNKEnumExtensionDRAM. Note how this example limits the number of sections to the number the kernel has indicated it can handle. By providing the sections in decreasing order of size, this code gives the kernel the largest possible amount of memory.

static DWORD OEMEnumExtensionDRAM(
  PMEMORY_SECTION pMemSections,
  DWORD cMemSections)
{
    DWORD cSections = 0;
    if (cSections < cMemSections)
    {
        pMemSections[cSections].dwFlags = 0;
        pMemSections[cSections].dwStart = 0x80000000;
        pMemSections[cSections].dwLen = 0x01000000;
        cSections++;
    }
    if (cSections < cMemSections)
    {
        pMemSections[cSections].dwFlags = 0;
        pMemSections[cSections].dwStart = 0x82000000;
        pMemSections[cSections].dwLen = 0x00f00000;
        cSections++;
    }
    if (cSections < cMemSections)
    {
        pMemSections[cSections].dwFlags = 0;
        pMemSections[cSections].dwStart = 0x81000000;
        pMemSections[cSections].dwLen = 0x00080000;
        cSections++;
    }
    return cSections;
}

Requirements

See Also

Reference

Optional OAL Functions
MainMemoryEndAddress
OEMInit
OEMGetExtensionDRAM
OEMEnumExtensionDRAM
MEMORY_SECTION