hipmemdiscardbatchasync Interface Reference

hipmemdiscardbatchasync Interface Reference#

HIPFORT API Reference: hipfort::hipmemdiscardbatchasync Interface Reference
hipfort::hipmemdiscardbatchasync Interface Reference

Discards a batch of memory ranges asynchronously. More...

Public Member Functions

integer(kind(hipsuccess)) function hipmemdiscardbatchasync_ (dev_ptrs, sizes, count, flags, stream)
 

Detailed Description

Discards a batch of memory ranges asynchronously.

Parameters
[in]dev_ptrspointers to the memory ranges to discard
[in]sizessizes in bytes of the memory ranges to discard
[in]countnumber of memory ranges to discard
[in]flagsflags for future use, must be zero now.
[in]streamstream to enqueue the discard operation
Returns
hipSuccess, hipErrorInvalidValue, hipErrorNotSupported
Warning
Reading from a discarded range without first writing or prefetching to it will return an indeterminate value.
Concurrent reads, writes, or prefetches to discarded ranges result in undefined behavior.
Note
All memory ranges must be managed memory allocated via hipMallocManaged or system-allocated memory (if device supports pageable memory access).
This API is implemented on Linux and requires XNACK to be enabled.
This API is marked as beta, meaning, while this is feature complete, it is still open to changes and may have outstanding issues.
See also
hipMemPrefetchBatchAsync, hipMallocManaged

Member Function/Subroutine Documentation

◆ hipmemdiscardbatchasync_()

integer(kind(hipsuccess)) function hipfort::hipmemdiscardbatchasync::hipmemdiscardbatchasync_ ( type(c_ptr)  dev_ptrs,
type(c_ptr), value  sizes,
integer(c_size_t), value  count,
integer(c_int64_t), value  flags,
type(c_ptr), value  stream 
)

The documentation for this interface was generated from the following file: