pNKEnumExtensionDRAM (Windows CE 5.0)

Article
09/14/2012

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.

Note If using more than two extended memory sections, the OEM must first change the kernel variable. For more information, see the Remarks section.

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

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Nkintr.h.
Link Library: Coredll.lib.