首页 > 解决方案 > 使用 Mupen64Plus 非托管 C dll API 命令填充 C# 结构

问题描述

我正在使用Mupen64Plus和包含的m64p_test_rom.v64文件。

我正在使用C#与用Cmupen64plus.dll编写的 API交谈。


问题

我正在尝试使用它的 API 命令M64CMD_ROM_GET_HEADER来获取 ROM 标头m64p_test_rom.v64,其中包含诸如Name, Manufacturer ID,之类的属性Country code。看起来该命令将数据存储在struct.

问题是,当调用 API 命令来填充 时struct,变量保持为空,它不会用新值填充它。


API

我正在使用 BizHawk 的这个 C# API 代码mupen64plus.dll.

命令

Mupen64Plus v2.0 核心前端维基

  1. CoreDoCommand(m64p_command Command, int ParamInt, void *ParamPtr)

    Command 枚举类型,指定应执行的命令。

    ParamInt:一个整数值,可用作命令的输入。
    ParamPtr:可用作命令输入的指针。

  2. M64CMD_ROM_GET_HEADER

    这将检索当前打开的 ROM 的标头数据。必须打开 ROM 映像。

    ParamInt:指向 rom_header 结构以接收数据的指针。
    ParamPtr:rom_header 结构的字节大小。


ROM头结构

在我的C#项目中,我创建了一个新struct的来匹配 Mupen64PlusC源代码中的那个。我不确定我是否已将其从正确转换C为。C#

Mupen64Plus C m64p_types.h

typedef struct
{
   uint8_t  init_PI_BSB_DOM1_LAT_REG;  /* 0x00 */
   uint8_t  init_PI_BSB_DOM1_PGS_REG;  /* 0x01 */
   uint8_t  init_PI_BSB_DOM1_PWD_REG;  /* 0x02 */
   uint8_t  init_PI_BSB_DOM1_PGS_REG2; /* 0x03 */
   uint32_t ClockRate;                 /* 0x04 */
   uint32_t PC;                        /* 0x08 */
   uint32_t Release;                   /* 0x0C */
   uint32_t CRC1;                      /* 0x10 */
   uint32_t CRC2;                      /* 0x14 */
   uint32_t Unknown[2];                /* 0x18 */
   uint8_t  Name[20];                  /* 0x20 */
   uint32_t unknown;                   /* 0x34 */
   uint32_t Manufacturer_ID;           /* 0x38 */
   uint16_t Cartridge_ID;              /* 0x3C - Game serial number  */
   uint16_t Country_code;              /* 0x3E */
} m64p_rom_header;

我的 C# 结构

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public struct m64p_rom_header
{
    public byte init_PI_BSB_DOM1_LAT_REG;  /* 0x00 */
    public byte init_PI_BSB_DOM1_PGS_REG;  /* 0x01 */
    public byte init_PI_BSB_DOM1_PWD_REG;  /* 0x02 */
    public byte init_PI_BSB_DOM1_PGS_REG2; /* 0x03 */
    public uint ClockRate;                 /* 0x04 */
    public uint PC;                        /* 0x08 */
    public uint Release;                   /* 0x0C */
    public uint CRC1;                      /* 0x10 */
    public uint CRC2;                      /* 0x14 */
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)]
    public uint[] Unknown;                 /* 0x18 */
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 20)]
    public byte[] Name;                    /* 0x20 */
    public uint unknown;                   /* 0x34 */
    public uint Manufacturer_ID;           /* 0x38 */
    public ushort Cartridge_ID;            /* 0x3C - Game serial number  */
    public ushort Country_code;            /* 0x3E */
};

非托管函数指针

我添加了一个新的委托声明,因此我可以使用 API 的CoreDoCommand()函数和M64CMD_ROM_GET_HEADER命令。

[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
delegate m64p_error CoreDoCommandStruct(m64p_command Command, m64p_rom_header ParamInt, ref int ParamPtr);
CoreDoCommandStruct m64pCoreDoCommandStruct;

ROM 获取头文件

我正在尝试检索 ROM 的名称。

运行 API 命令M64CMD_ROM_GET_HEADER应填充m64p_rom_header struct.

popertyName应返回为Mupen64Plus Demo by Marshallh (GPL).

我得到错误ArgumentNullException: Array cannot be null.rom_header.Name

当我调用命令时,ROM 已打开并正在运行。


public m64p_rom_header rom_header;

public String ROMGetHeader()
{
    // Get size of ROM Header struct
    int size = Marshal.SizeOf(typeof(m64p_rom_header)); // returns value of 20?

    // API ROM Get Header Command
    // Question: Populates all variables in the m64p_rom_header struct?
    m64pCoreDoCommandStruct(m64p_command.M64CMD_ROM_GET_HEADER, rom_header, ref size);

    // Return the byte Array and convert to String
    return System.Text.Encoding.Default.GetString(rom_header.Name); // <-- Error: Array null
}

标签: c#cstructdllunmanaged

解决方案


您以错误的顺序定义/传递参数给方法。委托的第二个参数是int类型,第三个参数是C中的void 指针,应该用于将数据作为引用传递。例如,您可以在您发送的链接 (BizHawk/mupen64pluseCoreApi.cs) 中找到以下代码:

// Pass the rom to the core
result = m64pCoreDoCommandByteArray(m64p_command.M64CMD_ROM_OPEN, rom.Length, rom);

所以委托的定义应该如下:

[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
delegate m64p_error CoreDoCommandStruct(m64p_command Command, int ParamInt, ref m64p_rom_header ParamPtr);
CoreDoCommandStruct m64pCoreDoCommandStruct;

并且您使用它的方式应该如下:

m64pCoreDoCommandStruct(m64p_command.M64CMD_ROM_GET_HEADER, size, ref rom_header);

推荐阅读