0

如何使用 jnr-ffi 将下面的函数映射到 java？

BOOLEAN PacketRequest(LPADAPTER AdapterObject,BOOLEAN Set,PPACKET_OID_DATA OidData);

示例（C）：https ://github.com/patmarion/winpcap/blob/master/WpcapSrc_4_1_3/Examples/PacketDriver/GetMacAddress/GetMacAddress.c

public interface NativeMappings {

    public static class PPACKET_OID_DATA extends Struct {

        public final UnsignedLong Oid = new UnsignedLong();
        public final UnsignedLong Length = new UnsignedLong();
        public final byte[] Data = new byte[6];

        public PPACKET_OID_DATA(Runtime runtime) {
           super(runtime);
        }

    }

    Pointer PacketOpenAdapter(String AdapterName);

    int PacketRequest(Pointer AdapterObject, int set, @Out PPACKET_OID_DATA OidData);

    void PacketCloseAdapter(Pointer lpAdapter);

    public static class Main {
        public static void main(String[] args) {
            NativeMappings mappings = LibraryLoader.create(NativeMappings.class).load("Packet");
            Runtime runtime = Runtime.getRuntime(mappings);
            Pointer adapterObject = mappings.PacketOpenAdapter("\\Device\\NPF_{53152A2F-39F7-458E-BD58-24D17099256A}");
            PPACKET_OID_DATA oid_data = new PPACKET_OID_DATA(runtime);
            oid_data.Oid.set(0x01010102L);
            oid_data.Length.set(6L);
            int status = mappings.PacketRequest(adapterObject, 0, oid_data);
            if (status == 0) {
                System.out.println("Fail.");
            } else {
                System.out.println("Success.");
            }
            mappings.PacketCloseAdapter(adapterObject);
        }
    }

}
4

1 回答 1

1

首先，要进行适当的映射，您应该查看要映射的类型的定义。PacketRequest函数返回BOOLEAN变量。根据windows数据类型描述，BOOLEAN声明为typedef BYTE BOOLEAN;. 这意味着，您可以byte在 java 中使用 type 作为函数类型。但是 JNR 也支持映射boolean类型到/从 native byte。所以两个定义都是正确的：

  • byte PacketRequest (...)
  • boolean PacketRequest (...)

接下来，您需要映射参数。同样在这里，看看定义，你就会知道要使用什么类型。结果将是：

boolean PacketRequest(Pointer AdapterObject, boolean set, PPACKET_OID_DATA OidData);

set参数被错误地声明为int。此外，@Out最后一个字段的注释告诉 JNR 传递一个空结构而不将值复制到本机内存。因此不会传递任何预设值。

最后一个参数的PPACKET_OID_DATA类型为-a 结构。

struct _PACKET_OID_DATA {
   ULONG Oid;                   ///< OID code. See the Microsoft DDK documentation or the file ntddndis.h
                                ///< for a complete list of valid codes.
   ULONG Length;                ///< Length of the data field
   UCHAR Data[1];               ///< variable-lenght field that contains the information passed to or received 
                                ///< from the adapter.
};

结构映射比原生类型要复杂一些。您不能在此处使用 java 类型。相反，您应该使用jnr.ffi.Struct内部类来定义结构字段。此规则包括数组定义。您的结构的正确定义如下所示：

class PPACKET_OID_DATA extends Struct {

    public final UnsignedLong Oid = new UnsignedLong();
    public final UnsignedLong Length = new UnsignedLong();
    public final Unsigned8[] Data = array(new Unsigned8[6]);

    public PPACKET_OID_DATA(Runtime runtime) {
        super(runtime);
    }

}

注意这个UCHAR数组定义。这种类型本身定义为unsigned char，因此对于 JNR 结构，它将映射到jnr.ffi.Strunc.Unsigned8类或jnr.ffi.Struct.BYTE（几乎相同）。

要声明一个数组字段，您应该在构造时初始化数组。您需要使用jnr.ffi.Struct#array(...)函数来正确执行此操作。这也意味着您应该知道数组的大小。示例如上所示。

为什么我们应该这样定义它？ 在初始化期间，Struct是某种可变长度的指针。在其中初始化的每个内部类字段都保留自己的空间，从而增加了该指针的最大大小。因此，每个字段都是某个内存片段的“视图”，具有与该内存交互的自己的方式（公共方法）。但是要制作这样的视图数组，您需要用视图实例填充空数组。这正是array函数的作用。

于 2018-09-10T08:50:47.470 回答