get_local_memory_handle


handle get_local_memory_handle(const void* memory)

This function obtains the handle of a local memory block.

Parameters

const void* memory

A pointer to the first byte of local memory whose handle is being obtained.

Return

handle

The handle of the memory or null if an error occurred.

Notes

When the function allocate_local_memory is used to allocate memory with the flag Localmemory_flag::moveable, the value returned is a handle to the local memory block. The function lock_local_memory is then used to convert the handle to a pointer to memory. This function performs the converse conversion; that is, it converts a pointer to memory back to a handle.