get_global_memory_handle


handle get_global_memory_handle(const void* memory)

This function obtains the handle of a global memory block.

Parameters

const void* memory

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

Return

handle

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

Notes

When the function allocate_global_memory is used to allocate memory with the flag global_memory_flag::moveable, the value returned is a handle to the global memory block. The function lock_global_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.