Restricted USM: malloc_host (2)

sycl::malloc_host

void* sycl::malloc_host(size_t num_bytes, const sycl::queue& q);
template <typename T>
T* sycl::malloc_host(size_t count, const sycl::queue& q);

Parameters

size_t num_bytes

Number of bytes to allocate

size_t count

Number of elements of type T to allocate

const sycl::queue& q

The SYCL queue whose context contains the devices that will access the host allocation

Return Value

Returns a pointer to the newly allocated host memory on success. Memory allocated by sycl::malloc_host must be deallocated with sycl::free to avoid memory leaks.

Returns nullptr on failure.