hipmempoolimportpointer Interface Reference

hipmempoolimportpointer Interface Reference#

HIPFORT API Reference: hipfort::hipmempoolimportpointer Interface Reference

Import a memory pool allocation from another process. More...

Public Member Functions
integer(kind(hipsuccess)) function	hipmempoolimportpointer_ (dev_ptr, mem_pool, export_data)

Detailed Description

Import a memory pool allocation from another process.

Returns in dev_ptr a pointer to the imported memory. The imported memory must not be accessed before the allocation operation completes in the exporting process. The imported memory must be freed from all importing processes before being freed in the exporting process. The pointer may be freed with hipFree or hipFreeAsync. If hipFreeAsync is used, the free must be completed on the importing process before the free operation on the exporting process.

Note: The hipFreeAsync api may be used in the exporting process before the hipFreeAsync operation completes in its stream as long as the hipFreeAsync in the exporting process specifies a stream with a stream dependency on the importing process's hipFreeAsync.

Parameters

[out]	dev_ptr	Pointer to imported memory
[in]	mem_pool	Memory pool from which to import a pointer
[in]	export_data	Data specifying the memory to import

Returns: hipSuccess, hipErrorInvalidValue, hipErrorNotInitialized, hipErrorOutOfMemory

See also: hipMemPoolExportPointer

Warning: This API is marked as Beta. While this feature is complete, it can change and might have outstanding issues.

Note: This API is implemented on Linux and is under development on Microsoft Windows.

Member Function/Subroutine Documentation