API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IMEMSPACE_MAPREGION()

Brew Release
Brew MP 1.0.2
See Also
Error Codes IMemGroup_CreateRegion IMemSpace
Description
Creates an IMemMap object that represents the mapping of a memory region into the address space of the calling process.
Params
pif
[in]:
interface pointer.
piMemRegion1
[in]:
the IMemRegion1 that needs to be mapped into the invoking process's address space.
ulPerms
[in]:
access permissions used to map this region, mapping of the region would fail if the permissions requested are higher than those used when region was created. Possible values are a combination of MEMREGION_ACCESS_READ, MEMREGION_ACCESS_WRITE, and MEMREGION_ACCESS_EXECUTE.
ulMapSize
[in]:
number of bytes of the region that need to be mapped.
ppiMemMap
[out]:
the memory map object created.
pulMapStart
[out]:
pointer to the start address of the mapped region.
pulMappedSize
[out]:
points to the actual number of bytes mapped.
Interface
Prototype
  •    AEEResult IMemSpace_MapRegion(IMemSpace* pif, 
                                     IMemRegion1* piMemRegion1, 
                                     uint32 ulPerms, 
                                     uint32 ulMapSize, 
                                     IMemMap** ppiMemMap, 
                                     uint32* pulMapStart, 
                                     uint32* pulMappedSize);
    
Return
  • AEE_SUCCESS: success. AEE_EFAILED: failure.
Side Effect
  • None.
Comments
None.