archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 23:04:50 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8299090: Specify coordinate order for additional CaptureCallState parameters on class as well

Browse source 
Reviewed-by: pminborg, mcimadamore
This commit is contained in:
Jorn Vernee 2023-01-12 06:49:27 +00:00
parent 945ef07564
commit 3918f9f523
1 changed files with 6 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

8
src/java.base/share/classes/java/lang/foreign/Linker.java
View file

@ -303,8 +303,8 @@ public sealed interface Linker permits AbstractLinker {
* before it can be overwritten by the Java runtime, or read through conventional means} * before it can be overwritten by the Java runtime, or read through conventional means}
* <p> * <p>
* A downcall method handle linked with this option will feature an additional {@link MemorySegment} * A downcall method handle linked with this option will feature an additional {@link MemorySegment}
* parameter directly following the target address parameter. This memory segment must be a * parameter directly following the target address, and optional {@link SegmentAllocator} parameters.
* native segment into which the captured state is written. * This memory segment must be a native segment into which the captured state is written.
* *
* @param capturedState the names of the values to save. * @param capturedState the names of the values to save.
* @see CaptureCallState#supported() * @see CaptureCallState#supported()
@ -323,6 +323,10 @@ public sealed interface Linker permits AbstractLinker {
* <p> * <p>
* Execution state is captured by a downcall method handle on invocation, by writing it * Execution state is captured by a downcall method handle on invocation, by writing it
* to a native segment provided by the user to the downcall method handle. * to a native segment provided by the user to the downcall method handle.
* For this purpose, a downcall method handle linked with the {@link #captureCallState(String[])}
* option will feature an additional {@link MemorySegment} parameter directly
* following the target address, and optional {@link SegmentAllocator} parameters.
* This parameter represents the native segment into which the captured state is written.
* <p> * <p>
* The native segment should have the layout {@linkplain CaptureCallState#layout associated} * The native segment should have the layout {@linkplain CaptureCallState#layout associated}
* with the particular {@code CaptureCallState} instance used to link the downcall handle. * with the particular {@code CaptureCallState} instance used to link the downcall handle.