Miles Sound System SDK 7.2a

AIL_vmm_lock

The function AIL_vmm_lock locks the specified memory range under DOS.

S32 AIL_vmm_lock(
  void const * start,
  U32 size
);

In Parameters

start: specifies the beginning memory address to lock.
size: specifies the size in bytes 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.

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 Sections: Memory management under DOS
Related Functions: AIL_mem_alloc_lock, AIL_vmm_lock_range, AIL_vmm_unlock
Related Basic Types: S32, U32, void const *