Miles Sound System SDK 7.2a

AIL_vmm_lock_range

The function AIL_vmm_lock_range locks the specified memory range under DOS.

S32 AIL_vmm_lock_range(
  void const * ptr1,
  void const * ptr2
);

In Parameters

ptr1: specifies the beginning memory address to lock.
ptr2: specifies the ending memory address to lock.

Returns

Whether the function succeeded or not.

Discussion

This function is DOS-only.

You must lock all code and data that will be accessed at callback time. This includes both code and data addresses.

This function is handy to lock code ranges because you generally don't know how long your procedures are in bytes. So for code ranges, use this function with the address of function that you want to lock for ptr1, and the address of the next function in the source file for ptr2.

Be careful when using empty functions with this call - occasionally optimizing compilers will move empty functions to save code space. The best way to ensure against this is to add a few lines of dummy code in your function.

You must lock all memory accessed at callback time. If your application runs fine under normal DOS, but fails under a DOS window in Windows, then you probably have forgotten to lock all of your memory.

This function must not be invoked from an interrupt-based callback function.

Group: Memory and File Services
Related Functions: AIL_mem_alloc_lock, AIL_vmm_lock, AIL_vmm_unlock_range
Related Basic Types: S32, void const *