handle get_global_memory_handle(const void* memory)

This function obtains the handle of a global memory block.


const void* memory

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



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


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.