Interface RPMemoryMapCallbackI
- All Known Implementing Classes:
RPMemoryMapCallback
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
RPMallocConfig
struct.
Type
void * (*invoke(long, long)
) (
size_t size,
size_t *offset
)
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
Pointer.Default
-
Field Summary
Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE
-
Method Summary
Modifier and TypeMethodDescriptiondefault void
callback
(long ret, long args) The Java method that will be called from native code when the native callback function is invoked.default FFICIF
Returns the libffi Call Interface for this callback function.long
invoke
(long size, long offset) Map memory pages for the given number of bytes.
-
Field Details
-
CIF
-
-
Method Details
-
getCallInterface
Description copied from interface:CallbackI
Returns the libffi Call Interface for this callback function. [INTERNAL API]- Specified by:
getCallInterface
in interfaceCallbackI
- Returns:
- the CIF structure for this callback function
-
callback
default void callback(long ret, long args) Description copied from interface:CallbackI
The Java method that will be called from native code when the native callback function is invoked.- Specified by:
callback
in interfaceCallbackI
- Parameters:
ret
- a pointer to the memory used for the function's return value.If the function is declared as returning
void
, then this value is garbage and should not be used.Otherwise, the callback must fill the object to which this points, following the same special promotion behavior as
LibFFI.ffi_call(org.lwjgl.system.libffi.FFICIF, long, java.nio.ByteBuffer, org.lwjgl.PointerBuffer)
. That is, in most cases,ret
points to an object of exactly the size of the type specified whenCIF
was constructed. However, integral types narrower than the system register size are widened. In these cases your program may assume thatret
points to anffi_arg
object.args
- a vector of pointers to memory holding the arguments to the function
-
invoke
long invoke(long size, long offset) Map memory pages for the given number of bytes.The returned address MUST be aligned to the rpmalloc span size, which will always be a power of two. Optionally the function can store an alignment offset in the offset variable in case it performs alignment and the returned pointer is offset from the actual start of the memory region due to this alignment. The alignment offset will be passed to the memory unmap function. The alignment offset MUST NOT be larger than 65535 (storable in an
uint16_t
), if it is you must use natural alignment to shift it into 16 bits.If you set a
memory_map
function, you must also set amemory_unmap
function or else the default implementation will be used for both.- Parameters:
size
- the number of bytes to mapoffset
- the alignment offset
-