Summary The omp_get_mapped_ptr routine returns the device pointer that is associated with a host pointer for a given device.
Constraints on Arguments The device_num argument must be greater than or equal to zero and less than or equal to the result of omp_get_num_devices().
Binding The binding task set for an omp_get_mapped_ptr region is the encountering task.
Effect The omp_get_mapped_ptr routine returns the associated device pointer on device device_num. A call to this routine for a pointer that is not NULL (or C_NULL_PTR, for Fortran) and does not have an associated pointer on the given device results in a NULL pointer.
The routine returns NULL (or C_NULL_PTR, for Fortran) if unsuccessful. Otherwise it returns the device pointer, which is ptr if device_num is the value returned by omp_get_initial_device().
The omp_get_mapped_ptr routine requires an explicit interface and so might not be provided in omp_lib.h.
Execution Model Events No events are associated with this routine.
Restrictions Restrictions to the omp_get_mapped_ptr routine are as follows.