Miles Sound System SDK 7.2a

AIL_mem_alloc_lock

The function AIL_mem_alloc_lock allocates a locked block of memory.

void * AIL_mem_alloc_lock(
  U32 size
);

The pointer to the new block of memory, or NULL if the allocation failed.

Under standard Windows platforms (Windows 9x, Windows NT), you don't have to use this function - you can just use normal memory.

Under DOS, you should use this function, or the AIL_vmm_lock functions, to ensure that the memory is available at interrupt time.

Under DOS and MacOS 9, this function must not be invoked from an interrupt-based callback function.

Example files that use this function: DEMO.C

Group: Memory and File Services
Related Sections: Memory management under Win32, Memory management under Win64
Related Functions: AIL_file_fss_read, AIL_file_read, AIL_mem_free_lock, AIL_mem_use_malloc, AIL_vmm_lock, AIL_vmm_lock_range
Related Basic Types: U32, void, void *
Related FAQs: How careful do I have to be when shutting down?