project64/Source/Android/PluginInput/Controller_1.1.h

// Common controller plugin specification, version 1.1

#pragma once
#include <stdint.h>

enum { PLUGIN_TYPE_CONTROLLER = 4 };

// Controller plugins

enum
{
    PLUGIN_NONE = 1,
    PLUGIN_MEMPAK = 2,
    PLUGIN_RUMBLE_PAK = 3,
    PLUGIN_TANSFER_PAK = 4,
    PLUGIN_RAW = 5,
};

#if defined(_WIN32)
#define EXPORT      extern "C" __declspec(dllexport)
#define CALL        __cdecl
#else
#define EXPORT      extern "C"  __attribute__((visibility("default")))
#define CALL
#endif

// Structures

typedef struct
{
    uint16_t Version;        // Should be set to 0x0101
    uint16_t Type;           // Set to PLUGIN_TYPE_CONTROLLER
    char Name[100];          // Name of the DLL
    int32_t Reserved1;
    int32_t Reserved2;
} PLUGIN_INFO;

typedef struct
{
    int32_t Present;
    int32_t RawData;
    int32_t Plugin;
} CONTROL;

#pragma warning(push)
#pragma warning(disable : 4201) // warning C4201: nonstandard extension used: nameless struct/union

typedef union
{
    uint32_t Value;
    struct
    {
        unsigned R_DPAD : 1;
        unsigned L_DPAD : 1;
        unsigned D_DPAD : 1;
        unsigned U_DPAD : 1;
        unsigned START_BUTTON : 1;
        unsigned Z_TRIG : 1;
        unsigned B_BUTTON : 1;
        unsigned A_BUTTON : 1;

        unsigned R_CBUTTON : 1;
        unsigned L_CBUTTON : 1;
        unsigned D_CBUTTON : 1;
        unsigned U_CBUTTON : 1;
        unsigned R_TRIG : 1;
        unsigned L_TRIG : 1;
        unsigned Reserved1 : 1;
        unsigned Reserved2 : 1;

        signed   X_AXIS : 8;

        signed   Y_AXIS : 8;
    };
} BUTTONS;
#pragma warning(pop)

typedef struct
{
    void * hMainWindow;
    void * hinst;

    int32_t MemoryBswaped;  // Memory in client or server-native endian
    uint8_t * HEADER;   // The ROM header (first 40h bytes of the ROM)
    CONTROL * Controls; // Pointer to array of 4 controllers, i.e.:  CONTROL Controls[4];
} CONTROL_INFO;

/*
Function: CloseDLL
Purpose:  This function is called when the emulator is closing
down allowing the DLL to de-initialize.
input:    none
output:   none
*/

EXPORT void CALL CloseDLL(void);

/*
Function: ControllerCommand
Purpose:  To process the raw data that has just been sent to a
specific controller.
input:    - Controller Number (0 to 3) and -1 signaling end of
processing the PIF RAM.
- Pointer of data to be processed.
output:   none

note:     This function is only needed if the DLL is allowing raw
data, or the plugin is set to raw

the data that is being processed looks like this:
initialize controller: 01 03 00 FF FF FF
read controller:      01 04 01 FF FF FF FF
*/

EXPORT void CALL ControllerCommand(int Control, uint8_t * Command);

/*
Function: DllAbout
Purpose:  This function is optional function that is provided
to give further information about the DLL.
input:    a handle to the window that calls this function
output:   none
*/

EXPORT void CALL DllAbout(void * hParent);

/*
Function: DllConfig
Purpose:  This function is optional function that is provided
to allow the user to configure the DLL
input:    a handle to the window that calls this function
output:   none
*/

EXPORT void CALL DllConfig(void * hParent);

/*
Function: DllTest
Purpose:  This function is optional function that is provided
to allow the user to test the DLL
input:    a handle to the window that calls this function
output:   none
*/

EXPORT void CALL DllTest(void * hParent);

/*
Function: GetDllInfo
Purpose:  This function allows the emulator to gather information
about the DLL by filling in the PluginInfo structure.
input:    a pointer to a PLUGIN_INFO structure that needs to be
filled by the function. (see def above)
output:   none
*/

EXPORT void CALL GetDllInfo(PLUGIN_INFO * PluginInfo);

/*
Function: GetKeys
Purpose:  To get the current state of the controllers buttons.
input:    - Controller Number (0 to 3)
- A pointer to a BUTTONS structure to be filled with
the controller state.
output:   none
*/

EXPORT void CALL GetKeys(int32_t Control, BUTTONS * Keys);

/*
Function: InitiateControllers
Purpose:  This function initializes how each of the controllers
should be handled.
input:    - The handle to the main window.
- A controller structure that needs to be filled for
the emulator to know how to handle each controller.
output:   none
*/

EXPORT void CALL InitiateControllers(CONTROL_INFO ControlInfo);

/*
Function: ReadController
Purpose:  To process the raw data in the PIF RAM that is about to
be read.
input:    - Controller Number (0 to 3) and -1 signaling end of
processing the PIF RAM.
- Pointer of data to be processed.
output:   none
note:     This function is only needed if the DLL is allowing raw
data.
*/

EXPORT void CALL ReadController(int Control, uint8_t * Command);

/*
Function: RomClosed
Purpose:  This function is called when a ROM is closed.
input:    none
output:   none
*/

EXPORT void CALL RomClosed(void);

/*
Function: RomOpen
Purpose:  This function is called when a ROM is open. (from the
emulation thread)
input:    none
output:   none
*/

EXPORT void CALL RomOpen(void);

/*
Function: WM_KeyDown
Purpose:  To pass the WM_KeyDown message from the emulator to the
plugin.
input:    wParam and lParam of the WM_KEYDOWN message.
output:   none
*/

EXPORT void CALL WM_KeyDown(uint32_t wParam, uint32_t lParam);

/*
Function: WM_KeyUp
Purpose:  To pass the WM_KEYUP message from the emulator to the
plugin.
input:    wParam and lParam of the WM_KEYDOWN message.
output:   none
*/

EXPORT void CALL WM_KeyUp(uint32_t wParam, uint32_t lParam);