From 645e6cba1d802b2b2d24f8e7c01487eb38960b88 Mon Sep 17 00:00:00 2001
From: Tau <tau@nowhere>
Date: Sun, 6 Jun 2021 09:40:55 -0400
Subject: [PATCH] Add api versioning to divaio

---
 divaio/divaio.c |  5 +++++
 divaio/divaio.h | 37 ++++++++++++++++++++++++++++++-------
 2 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/divaio/divaio.c b/divaio/divaio.c
index 4982482..7db2075 100644
--- a/divaio/divaio.c
+++ b/divaio/divaio.c
@@ -16,6 +16,11 @@ static HANDLE diva_io_slider_thread;
 static bool diva_io_slider_stop_flag;
 static struct diva_io_config diva_io_cfg;
 
+uint16_t diva_io_get_api_version(void)
+{
+    return 0x0100;
+}
+
 HRESULT diva_io_jvs_init(void)
 {
     diva_io_config_load(&diva_io_cfg, L".\\segatools.ini");
diff --git a/divaio/divaio.h b/divaio/divaio.h
index 3de0d1a..202704e 100644
--- a/divaio/divaio.h
+++ b/divaio/divaio.h
@@ -5,13 +5,24 @@
 #include <stdbool.h>
 #include <stdint.h>
 
+/* Get the version of the Project Diva IO API that this DLL supports. This
+   function should return a positive 16-bit integer, where the high byte is
+   the major version and the low byte is the minor version (as defined by the
+   Semantic Versioning standard).
+
+   The latest API version as of this writing is 0x0100. */
+
+uint16_t diva_io_get_api_version(void);
+
 /* Initialize JVS-based input. This function will be called before any other
    diva_io_jvs_*() function calls. Errors returned from this function will
    manifest as a disconnected JVS bus.
 
    All subsequent calls may originate from arbitrary threads and some may
    overlap with each other. Ensuring synchronization inside your IO DLL is
-   your responsibility. */
+   your responsibility.
+
+   Minimum API version: 0x0100 */
 
 HRESULT diva_io_jvs_init(void);
 
@@ -22,13 +33,17 @@ HRESULT diva_io_jvs_init(void);
 
    gamebtn bits, from least significant to most significant, are:
 
-   Circle Cross Square Triangle Start UNUSED UNUSED UNUSED */
+   Circle Cross Square Triangle Start UNUSED UNUSED UNUSED
+
+   Minimum API version: 0x0100 */
 
 void diva_io_jvs_poll(uint8_t *opbtn, uint8_t *gamebtn);
 
 /* Read the current state of the coin counter. This value should be incremented
    for every coin detected by the coin acceptor mechanism. This count does not
-   need to persist beyond the lifetime of the process. */
+   need to persist beyond the lifetime of the process.
+
+   Minimum API Version: 0x0100 */
 
 void diva_io_jvs_read_coin_counter(uint16_t *out);
 
@@ -43,7 +58,9 @@ void diva_io_jvs_set_coin_blocker(bool open);
 
    All subsequent calls may originate from arbitrary threads and some may
    overlap with each other. Ensuring synchronization inside your IO DLL is
-   your responsibility. */
+   your responsibility.
+
+   Minimum API version: 0x0100 */
 
 HRESULT diva_io_slider_init(void);
 
@@ -67,7 +84,9 @@ typedef void (*diva_io_slider_callback_t)(const uint8_t *state);
    preferred interval then 1 kHz is a reasonable maximum frequency.
 
    Note that you do have to have to call the callback "occasionally" even if
-   nothing is changing, otherwise the game will raise a comm timeout error. */
+   nothing is changing, otherwise the game will raise a comm timeout error.
+
+   Minimum API version: 0x0100 */
 
 void diva_io_slider_start(diva_io_slider_callback_t callback);
 
@@ -80,11 +99,15 @@ void diva_io_slider_start(diva_io_slider_callback_t callback);
 
    Following on from the above, the slider polling loop *will* be restarted
    after being stopped in the course of regular operation. Do not permanently
-   tear down your input driver in response to this function call. */
+   tear down your input driver in response to this function call.
+
+   Minimum API version: 0x0100 */
 
 void diva_io_slider_stop(void);
 
 /* Update the RGB lighting on the slider. A pointer to an array of 32 * 3 = 96
-   bytes is supplied. Layout is probably strictly linear but still TBD. */
+   bytes is supplied. Layout is probably strictly linear but still TBD.
+
+   Minimum API version: 0x0100 */
 
 void diva_io_slider_set_leds(const uint8_t *rgb);