LWJGL 3.3.3 · org.lwjgl.system.jemalloc.ExtentAllocI

Modifier and Type	Field and Description
public static final FFICIF	CIF

Method Summary

Modifier and Type	Method and Description
public default void	callback(long 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`. That is, in most cases, `ret` points to an object of exactly the size of the type specified when `CIF` was constructed. However, integral types narrower than the system register size are widened. In these cases your program may assume that `ret` points to an `ffi_arg` object. ret, long a vector of pointers to memory holding the arguments to the function args) Implements org.lwjgl.system.CallbackI.callback. The Java method that will be called from native code when the native callback function is invoked.
public default FFICIF	getCallInterface() Implements org.lwjgl.system.CallbackI.getCallInterface. Returns the libffi Call Interface for this callback function.
public long	invoke(long extent_hooks, long new_addr, long size, long alignment, long zero, long commit, int arena_ind) Extent allocation hook.

Inherited from org.lwjgl.system.CallbackI:: address

CIF	back to summary
public static final FFICIF CIF

Method Detail

callback back to summary

callback	back to summary
public default void callback(long ret, long args) Implements org.lwjgl.system.CallbackI.callback. Doc from org.lwjgl.system.CallbackI.callback. The Java method that will be called from native code when the native callback function is invoked. Parameters ret:long 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`. That is, in most cases, `ret` points to an object of exactly the size of the type specified when `CIF` was constructed. However, integral types narrower than the system register size are widened. In these cases your program may assume that `ret` points to an `ffi_arg` object. args:long a vector of pointers to memory holding the arguments to the function Annotations @Override

public default void callback(long ret, long args)

Implements org.lwjgl.system.CallbackI.callback.

Doc from org.lwjgl.system.CallbackI.callback.

The Java method that will be called from native code when the native callback function is invoked.

Parameters

ret:long

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. That is, in most cases, ret points to an object of exactly the size of the type specified when CIF was constructed. However, integral types narrower than the system register size are widened. In these cases your program may assume that ret points to an ffi_arg object.

args:long

a vector of pointers to memory holding the arguments to the function

Annotations

@Override

getCallInterface	back to summary
public default FFICIF getCallInterface() Implements org.lwjgl.system.CallbackI.getCallInterface. Doc from org.lwjgl.system.CallbackI.getCallInterface. Returns the libffi Call Interface for this callback function. [INTERNAL API] Returns:FFICIF the CIF structure for this callback function Annotations @Override

getCallInterface

back to summary

public default FFICIF getCallInterface()

Implements org.lwjgl.system.CallbackI.getCallInterface.

Doc from org.lwjgl.system.CallbackI.getCallInterface.

Returns the libffi Call Interface for this callback function. [INTERNAL API]

Returns:FFICIF

the CIF structure for this callback function

Annotations

@Override

invoke back to summary

invoke	back to summary
public long invoke(long extent_hooks, long new_addr, long size, long alignment, long zero, long commit, int arena_ind) Extent allocation hook. An extent allocation function conforms to the `extent_alloc_t` type and upon success returns a pointer to `size` bytes of mapped memory on behalf of arena `arena_ind` such that the extent's base address is a multiple of `alignment`, as well as setting `zero` to indicate whether the extent is zeroed and `commit` to indicate whether the extent is committed. Upon error the function returns `NULL` and leaves `zero` and `commit` unmodified. The `size` parameter is always a multiple of the page size. The `alignment` parameter is always a power of two at least as large as the page size. Zeroing is mandatory if `zero` is true upon function entry. Committing is mandatory if `commit` is true upon function entry. If `new_addr` is not `NULL`, the returned pointer must be `new_addr` on success or `NULL` on error. Committed memory may be committed in absolute terms as on a system that does not overcommit, or in implicit terms as on a system that overcommits and satisfies physical memory needs on demand via soft page faults. Note that replacing the default extent allocation function makes the arena's `arena.i.dss` setting irrelevant. Annotations @NativeType:void *

public long invoke(long extent_hooks, long new_addr, long size, long alignment, long zero, long commit, int arena_ind)

Extent allocation hook.

An extent allocation function conforms to the extent_alloc_t type and upon success returns a pointer to size bytes of mapped memory on behalf of arena arena_ind such that the extent's base address is a multiple of alignment, as well as setting *zero to indicate whether the extent is zeroed and *commit to indicate whether the extent is committed. Upon error the function returns NULL and leaves *zero and *commit unmodified. The size parameter is always a multiple of the page size. The alignment parameter is always a power of two at least as large as the page size. Zeroing is mandatory if *zero is true upon function entry. Committing is mandatory if *commit is true upon function entry. If new_addr is not NULL, the returned pointer must be new_addr on success or NULL on error. Committed memory may be committed in absolute terms as on a system that does not overcommit, or in implicit terms as on a system that overcommits and satisfies physical memory needs on demand via soft page faults. Note that replacing the default extent allocation function makes the arena's arena.i.dss setting irrelevant.

Annotations

@NativeType:void *

public Interface ExtentAllocI

Type

Field Summary

Method Summary

Field Detail

Method Detail