os_alloc(D3psm)

os_alloc -- allocate memory

Synopsis

   void *os_alloc(ms_size_t size)

Description

os_alloc allocates at least size bytes of memory. No alignment or special properties are guaranteed, except that the memory will be suitably aligned for storage of any software data type. This call may or may not wait for more memory if it is not immediately available. It returns NULL on failure.

os_alloc may be called from pfxinitpsm or from the following entry points:

Arguments

size: the number of bytes of memory to allocate

Return values

Returns a void * pointer to the allocated area. If memory allocation fails, then NULL is returned.

Usage

Hardware applicability

All.

Version applicability

psm: 2

References

MSOP_INIT_CPU(D2psm), MSOP_START_CPU(D2psm), MSOP_INTR_ATTACH(D2psm), MSOP_INTR_DETACH(D2psm), os_alloc_pages(D3psm)