src/joystick/windows/SDL_mmjoystick.c
author Ryan C. Gordon
Tue, 24 Jan 2017 16:18:25 -0500
changeset 10850 c9dc0068b0e7
parent 10818 7e06b0e4dbe0
child 11811 5d94cb6b24d3
permissions -rw-r--r--
configure: report libsamplerate support status.
slouken@0
     1
/*
slouken@5535
     2
  Simple DirectMedia Layer
slouken@10737
     3
  Copyright (C) 1997-2017 Sam Lantinga <slouken@libsdl.org>
slouken@0
     4
slouken@5535
     5
  This software is provided 'as-is', without any express or implied
slouken@5535
     6
  warranty.  In no event will the authors be held liable for any damages
slouken@5535
     7
  arising from the use of this software.
slouken@0
     8
slouken@5535
     9
  Permission is granted to anyone to use this software for any purpose,
slouken@5535
    10
  including commercial applications, and to alter it and redistribute it
slouken@5535
    11
  freely, subject to the following restrictions:
slouken@0
    12
slouken@5535
    13
  1. The origin of this software must not be misrepresented; you must not
slouken@5535
    14
     claim that you wrote the original software. If you use this software
slouken@5535
    15
     in a product, an acknowledgment in the product documentation would be
slouken@5535
    16
     appreciated but is not required.
slouken@5535
    17
  2. Altered source versions must be plainly marked as such, and must not be
slouken@5535
    18
     misrepresented as being the original software.
slouken@5535
    19
  3. This notice may not be removed or altered from any source distribution.
slouken@0
    20
*/
icculus@8093
    21
#include "../../SDL_internal.h"
slouken@0
    22
slouken@1635
    23
#ifdef SDL_JOYSTICK_WINMM
slouken@1635
    24
slouken@0
    25
/* Win32 MultiMedia Joystick driver, contributed by Andrei de A. Formiga */
slouken@0
    26
slouken@5090
    27
#include "../../core/windows/SDL_windows.h"
slouken@1358
    28
#include <mmsystem.h>
slouken@1358
    29
#include <regstr.h>
slouken@1358
    30
slouken@1330
    31
#include "SDL_events.h"
slouken@0
    32
#include "SDL_joystick.h"
slouken@1361
    33
#include "../SDL_sysjoystick.h"
slouken@1361
    34
#include "../SDL_joystick_c.h"
slouken@0
    35
slouken@7828
    36
#ifdef REGSTR_VAL_JOYOEMNAME 
slouken@7828
    37
#undef REGSTR_VAL_JOYOEMNAME 
slouken@7828
    38
#endif
slouken@7828
    39
#define REGSTR_VAL_JOYOEMNAME "OEMName"
slouken@7828
    40
slouken@7191
    41
#define MAX_JOYSTICKS   16
slouken@7191
    42
#define MAX_AXES    6       /* each joystick can have up to 6 axes */
slouken@7191
    43
#define MAX_BUTTONS 32      /* and 32 buttons                      */
slouken@7191
    44
#define JOY_BUTTON_FLAG(n)  (1<<n)
slouken@0
    45
slouken@0
    46
slouken@0
    47
/* array to hold joystick ID values */
slouken@1895
    48
static UINT SYS_JoystickID[MAX_JOYSTICKS];
slouken@7828
    49
static JOYCAPSA SYS_Joystick[MAX_JOYSTICKS];
slouken@1895
    50
static char *SYS_JoystickName[MAX_JOYSTICKS];
slouken@0
    51
slouken@0
    52
/* The private structure used to keep track of a joystick */
slouken@0
    53
struct joystick_hwdata
slouken@0
    54
{
slouken@1895
    55
    /* joystick ID */
slouken@1895
    56
    UINT id;
slouken@0
    57
slouken@1895
    58
    /* values used to translate device-specific coordinates into
slouken@1895
    59
       SDL-standard ranges */
slouken@1895
    60
    struct _transaxis
slouken@1895
    61
    {
slouken@1895
    62
        int offset;
slouken@1895
    63
        float scale;
slouken@1895
    64
    } transaxis[6];
slouken@0
    65
};
slouken@0
    66
slouken@5062
    67
/* Convert a Windows Multimedia API return code to a text message */
slouken@0
    68
static void SetMMerror(char *function, int code);
slouken@0
    69
slouken@0
    70
slouken@1895
    71
static char *
slouken@1895
    72
GetJoystickName(int index, const char *szRegKey)
slouken@937
    73
{
slouken@1895
    74
    /* added 7/24/2004 by Eckhard Stolberg */
slouken@1895
    75
    /*
slouken@1895
    76
       see if there is a joystick for the current
slouken@1895
    77
       index (1-16) listed in the registry
slouken@1895
    78
     */
slouken@1895
    79
    char *name = NULL;
slouken@2176
    80
    HKEY hTopKey;
slouken@1895
    81
    HKEY hKey;
slouken@1895
    82
    DWORD regsize;
slouken@1895
    83
    LONG regresult;
slouken@2176
    84
    char regkey[256];
slouken@2176
    85
    char regvalue[256];
slouken@2176
    86
    char regname[256];
slouken@2176
    87
slouken@10818
    88
    SDL_snprintf(regkey, SDL_arraysize(regkey),
slouken@10818
    89
#ifdef UNICODE
slouken@10818
    90
                 "%S\\%s\\%S",
slouken@10818
    91
#else
slouken@10818
    92
                 "%s\\%s\\%s",
slouken@10818
    93
#endif
slouken@2176
    94
                 REGSTR_PATH_JOYCONFIG, szRegKey, REGSTR_KEY_JOYCURR);
slouken@2176
    95
    hTopKey = HKEY_LOCAL_MACHINE;
slouken@2176
    96
    regresult = RegOpenKeyExA(hTopKey, regkey, 0, KEY_READ, &hKey);
slouken@2176
    97
    if (regresult != ERROR_SUCCESS) {
slouken@2176
    98
        hTopKey = HKEY_CURRENT_USER;
slouken@2176
    99
        regresult = RegOpenKeyExA(hTopKey, regkey, 0, KEY_READ, &hKey);
slouken@2176
   100
    }
slouken@2176
   101
    if (regresult != ERROR_SUCCESS) {
slouken@2176
   102
        return NULL;
slouken@2176
   103
    }
slouken@937
   104
slouken@2176
   105
    /* find the registry key name for the joystick's properties */
slouken@2176
   106
    regsize = sizeof(regname);
slouken@2176
   107
    SDL_snprintf(regvalue, SDL_arraysize(regvalue), "Joystick%d%s", index + 1,
slouken@2176
   108
                 REGSTR_VAL_JOYOEMNAME);
slouken@2176
   109
    regresult =
slouken@2176
   110
        RegQueryValueExA(hKey, regvalue, 0, 0, (LPBYTE) regname, &regsize);
slouken@2176
   111
    RegCloseKey(hKey);
slouken@2176
   112
slouken@2176
   113
    if (regresult != ERROR_SUCCESS) {
slouken@2176
   114
        return NULL;
slouken@2176
   115
    }
slouken@2176
   116
slouken@2176
   117
    /* open that registry key */
slouken@10818
   118
    SDL_snprintf(regkey, SDL_arraysize(regkey),
slouken@10818
   119
#ifdef UNICODE
slouken@10818
   120
                 "%S\\%s",
slouken@10818
   121
#else
slouken@10818
   122
                 "%s\\%s",
slouken@10818
   123
#endif
slouken@10818
   124
                 REGSTR_PATH_JOYOEM, regname);
slouken@2176
   125
    regresult = RegOpenKeyExA(hTopKey, regkey, 0, KEY_READ, &hKey);
slouken@2176
   126
    if (regresult != ERROR_SUCCESS) {
slouken@2176
   127
        return NULL;
slouken@2176
   128
    }
slouken@2176
   129
slouken@2176
   130
    /* find the size for the OEM name text */
slouken@2176
   131
    regsize = sizeof(regvalue);
slouken@2176
   132
    regresult =
slouken@2176
   133
        RegQueryValueExA(hKey, REGSTR_VAL_JOYOEMNAME, 0, 0, NULL, &regsize);
slouken@1895
   134
    if (regresult == ERROR_SUCCESS) {
slouken@2176
   135
        /* allocate enough memory for the OEM name text ... */
slouken@2176
   136
        name = (char *) SDL_malloc(regsize);
slouken@2176
   137
        if (name) {
slouken@2176
   138
            /* ... and read it from the registry */
slouken@2176
   139
            regresult = RegQueryValueExA(hKey,
slouken@1895
   140
                                         REGSTR_VAL_JOYOEMNAME, 0, 0,
slouken@2176
   141
                                         (LPBYTE) name, &regsize);
slouken@1895
   142
        }
slouken@1895
   143
    }
slouken@2176
   144
    RegCloseKey(hKey);
slouken@2176
   145
slouken@1895
   146
    return (name);
slouken@937
   147
}
slouken@937
   148
slouken@6698
   149
static int SDL_SYS_numjoysticks = 0;
slouken@6698
   150
slouken@0
   151
/* Function to scan the system for joysticks.
philipp@9311
   152
 * Joystick 0 should be the system default joystick.
slouken@0
   153
 * It should return 0, or -1 on an unrecoverable fatal error.
slouken@0
   154
 */
slouken@1895
   155
int
slouken@1895
   156
SDL_SYS_JoystickInit(void)
slouken@0
   157
{
slouken@1895
   158
    int i;
slouken@1895
   159
    int maxdevs;
slouken@1895
   160
    JOYINFOEX joyinfo;
slouken@7828
   161
    JOYCAPSA joycaps;
slouken@1895
   162
    MMRESULT result;
slouken@0
   163
slouken@1895
   164
    /* Reset the joystick ID & name mapping tables */
slouken@1895
   165
    for (i = 0; i < MAX_JOYSTICKS; ++i) {
slouken@1895
   166
        SYS_JoystickID[i] = 0;
slouken@1895
   167
        SYS_JoystickName[i] = NULL;
slouken@1895
   168
    }
slouken@531
   169
slouken@1895
   170
    /* Loop over all potential joystick devices */
slouken@6698
   171
    SDL_SYS_numjoysticks = 0;
slouken@1895
   172
    maxdevs = joyGetNumDevs();
slouken@6698
   173
    for (i = JOYSTICKID1; i < maxdevs && SDL_SYS_numjoysticks < MAX_JOYSTICKS; ++i) {
slouken@1895
   174
slouken@1895
   175
        joyinfo.dwSize = sizeof(joyinfo);
slouken@1895
   176
        joyinfo.dwFlags = JOY_RETURNALL;
icculus@2061
   177
        result = joyGetPosEx(i, &joyinfo);
slouken@1895
   178
        if (result == JOYERR_NOERROR) {
slouken@7828
   179
            result = joyGetDevCapsA(i, &joycaps, sizeof(joycaps));
slouken@1895
   180
            if (result == JOYERR_NOERROR) {
slouken@6698
   181
                SYS_JoystickID[SDL_SYS_numjoysticks] = i;
slouken@6698
   182
                SYS_Joystick[SDL_SYS_numjoysticks] = joycaps;
slouken@6698
   183
                SYS_JoystickName[SDL_SYS_numjoysticks] =
slouken@1895
   184
                    GetJoystickName(i, joycaps.szRegKey);
slouken@6698
   185
                SDL_SYS_numjoysticks++;
slouken@1895
   186
            }
slouken@1895
   187
        }
slouken@1895
   188
    }
slouken@6698
   189
    return (SDL_SYS_numjoysticks);
slouken@0
   190
}
slouken@0
   191
philipp@10617
   192
int
philipp@10617
   193
SDL_SYS_NumJoysticks(void)
slouken@6707
   194
{
slouken@6707
   195
    return SDL_SYS_numjoysticks;
slouken@6707
   196
}
slouken@6707
   197
philipp@10617
   198
void
philipp@10617
   199
SDL_SYS_JoystickDetect(void)
slouken@6707
   200
{
slouken@6707
   201
}
slouken@6707
   202
slouken@0
   203
/* Function to get the device-dependent name of a joystick */
slouken@1895
   204
const char *
slouken@6707
   205
SDL_SYS_JoystickNameForDeviceIndex(int device_index)
slouken@0
   206
{
slouken@6707
   207
    if (SYS_JoystickName[device_index] != NULL) {
slouken@6707
   208
        return (SYS_JoystickName[device_index]);
slouken@1895
   209
    } else {
slouken@6707
   210
        return (SYS_Joystick[device_index].szPname);
slouken@1895
   211
    }
slouken@0
   212
}
slouken@0
   213
slouken@6707
   214
/* Function to perform the mapping from device index to the instance id for this index */
slouken@6707
   215
SDL_JoystickID SDL_SYS_GetInstanceIdOfDeviceIndex(int device_index)
slouken@6707
   216
{
slouken@6707
   217
    return device_index;
slouken@6707
   218
}
slouken@6707
   219
slouken@0
   220
/* Function to open a joystick for use.
philipp@9380
   221
   The joystick to open is specified by the device index.
slouken@0
   222
   This should fill the nbuttons and naxes fields of the joystick structure.
slouken@0
   223
   It returns 0, or -1 if there is an error.
slouken@0
   224
 */
slouken@1895
   225
int
slouken@6698
   226
SDL_SYS_JoystickOpen(SDL_Joystick * joystick, int device_index)
slouken@0
   227
{
slouken@1895
   228
    int index, i;
slouken@1895
   229
    int caps_flags[MAX_AXES - 2] =
slouken@1895
   230
        { JOYCAPS_HASZ, JOYCAPS_HASR, JOYCAPS_HASU, JOYCAPS_HASV };
slouken@1895
   231
    int axis_min[MAX_AXES], axis_max[MAX_AXES];
slouken@0
   232
slouken@0
   233
slouken@1895
   234
    /* shortcut */
slouken@6698
   235
    index = device_index;
slouken@1895
   236
    axis_min[0] = SYS_Joystick[index].wXmin;
slouken@1895
   237
    axis_max[0] = SYS_Joystick[index].wXmax;
slouken@1895
   238
    axis_min[1] = SYS_Joystick[index].wYmin;
slouken@1895
   239
    axis_max[1] = SYS_Joystick[index].wYmax;
slouken@1895
   240
    axis_min[2] = SYS_Joystick[index].wZmin;
slouken@1895
   241
    axis_max[2] = SYS_Joystick[index].wZmax;
slouken@1895
   242
    axis_min[3] = SYS_Joystick[index].wRmin;
slouken@1895
   243
    axis_max[3] = SYS_Joystick[index].wRmax;
slouken@1895
   244
    axis_min[4] = SYS_Joystick[index].wUmin;
slouken@1895
   245
    axis_max[4] = SYS_Joystick[index].wUmax;
slouken@1895
   246
    axis_min[5] = SYS_Joystick[index].wVmin;
slouken@1895
   247
    axis_max[5] = SYS_Joystick[index].wVmax;
slouken@0
   248
slouken@1895
   249
    /* allocate memory for system specific hardware data */
slouken@6698
   250
    joystick->instance_id = device_index;
slouken@1895
   251
    joystick->hwdata =
slouken@1895
   252
        (struct joystick_hwdata *) SDL_malloc(sizeof(*joystick->hwdata));
slouken@1895
   253
    if (joystick->hwdata == NULL) {
icculus@7037
   254
        return SDL_OutOfMemory();
slouken@1895
   255
    }
slouken@1895
   256
    SDL_memset(joystick->hwdata, 0, sizeof(*joystick->hwdata));
slouken@0
   257
slouken@1895
   258
    /* set hardware data */
slouken@1895
   259
    joystick->hwdata->id = SYS_JoystickID[index];
slouken@1895
   260
    for (i = 0; i < MAX_AXES; ++i) {
slouken@1895
   261
        if ((i < 2) || (SYS_Joystick[index].wCaps & caps_flags[i - 2])) {
slouken@10724
   262
            joystick->hwdata->transaxis[i].offset = SDL_JOYSTICK_AXIS_MIN - axis_min[i];
slouken@1895
   263
            joystick->hwdata->transaxis[i].scale =
slouken@10724
   264
                (float) (SDL_JOYSTICK_AXIS_MAX - SDL_JOYSTICK_AXIS_MIN) / (axis_max[i] - axis_min[i]);
slouken@1895
   265
        } else {
slouken@1895
   266
            joystick->hwdata->transaxis[i].offset = 0;
slouken@1895
   267
            joystick->hwdata->transaxis[i].scale = 1.0; /* Just in case */
slouken@1895
   268
        }
slouken@1895
   269
    }
slouken@1895
   270
slouken@1895
   271
    /* fill nbuttons, naxes, and nhats fields */
slouken@1895
   272
    joystick->nbuttons = SYS_Joystick[index].wNumButtons;
slouken@1895
   273
    joystick->naxes = SYS_Joystick[index].wNumAxes;
slouken@1895
   274
    if (SYS_Joystick[index].wCaps & JOYCAPS_HASPOV) {
slouken@1895
   275
        joystick->nhats = 1;
slouken@1895
   276
    } else {
slouken@1895
   277
        joystick->nhats = 0;
slouken@1895
   278
    }
slouken@1895
   279
    return (0);
slouken@0
   280
}
slouken@0
   281
philipp@9561
   282
/* Function to determine if this joystick is attached to the system right now */
slouken@6707
   283
SDL_bool SDL_SYS_JoystickAttached(SDL_Joystick *joystick)
slouken@6707
   284
{
slouken@6707
   285
    return SDL_TRUE;
slouken@6707
   286
}
slouken@6707
   287
slouken@1895
   288
static Uint8
slouken@1895
   289
TranslatePOV(DWORD value)
slouken@0
   290
{
slouken@1895
   291
    Uint8 pos;
slouken@0
   292
slouken@1895
   293
    pos = SDL_HAT_CENTERED;
slouken@1895
   294
    if (value != JOY_POVCENTERED) {
slouken@1895
   295
        if ((value > JOY_POVLEFT) || (value < JOY_POVRIGHT)) {
slouken@1895
   296
            pos |= SDL_HAT_UP;
slouken@1895
   297
        }
slouken@1895
   298
        if ((value > JOY_POVFORWARD) && (value < JOY_POVBACKWARD)) {
slouken@1895
   299
            pos |= SDL_HAT_RIGHT;
slouken@1895
   300
        }
slouken@1895
   301
        if ((value > JOY_POVRIGHT) && (value < JOY_POVLEFT)) {
slouken@1895
   302
            pos |= SDL_HAT_DOWN;
slouken@1895
   303
        }
slouken@1895
   304
        if (value > JOY_POVBACKWARD) {
slouken@1895
   305
            pos |= SDL_HAT_LEFT;
slouken@1895
   306
        }
slouken@1895
   307
    }
slouken@1895
   308
    return (pos);
slouken@0
   309
}
slouken@0
   310
slouken@0
   311
/* Function to update the state of a joystick - called as a device poll.
slouken@0
   312
 * This function shouldn't update the joystick structure directly,
slouken@0
   313
 * but instead should call SDL_PrivateJoystick*() to deliver events
slouken@0
   314
 * and update joystick device state.
slouken@0
   315
 */
slouken@1895
   316
void
slouken@1895
   317
SDL_SYS_JoystickUpdate(SDL_Joystick * joystick)
slouken@0
   318
{
slouken@1895
   319
    MMRESULT result;
slouken@1895
   320
    int i;
slouken@1895
   321
    DWORD flags[MAX_AXES] = { JOY_RETURNX, JOY_RETURNY, JOY_RETURNZ,
slouken@1895
   322
        JOY_RETURNR, JOY_RETURNU, JOY_RETURNV
slouken@1895
   323
    };
slouken@1895
   324
    DWORD pos[MAX_AXES];
slouken@1895
   325
    struct _transaxis *transaxis;
slouken@10818
   326
    int value;
slouken@1895
   327
    JOYINFOEX joyinfo;
slouken@0
   328
slouken@1895
   329
    joyinfo.dwSize = sizeof(joyinfo);
slouken@1895
   330
    joyinfo.dwFlags = JOY_RETURNALL | JOY_RETURNPOVCTS;
slouken@1895
   331
    if (!joystick->hats) {
slouken@1895
   332
        joyinfo.dwFlags &= ~(JOY_RETURNPOV | JOY_RETURNPOVCTS);
slouken@1895
   333
    }
slouken@1895
   334
    result = joyGetPosEx(joystick->hwdata->id, &joyinfo);
slouken@1895
   335
    if (result != JOYERR_NOERROR) {
slouken@1895
   336
        SetMMerror("joyGetPosEx", result);
slouken@1895
   337
        return;
slouken@1895
   338
    }
slouken@0
   339
slouken@1895
   340
    /* joystick motion events */
slouken@1895
   341
    pos[0] = joyinfo.dwXpos;
slouken@1895
   342
    pos[1] = joyinfo.dwYpos;
slouken@1895
   343
    pos[2] = joyinfo.dwZpos;
slouken@1895
   344
    pos[3] = joyinfo.dwRpos;
slouken@1895
   345
    pos[4] = joyinfo.dwUpos;
slouken@1895
   346
    pos[5] = joyinfo.dwVpos;
slouken@0
   347
slouken@1895
   348
    transaxis = joystick->hwdata->transaxis;
slouken@1895
   349
    for (i = 0; i < joystick->naxes; i++) {
slouken@1895
   350
        if (joyinfo.dwFlags & flags[i]) {
slouken@10745
   351
            value = (int) (((float) pos[i] + transaxis[i].offset) * transaxis[i].scale);
slouken@10745
   352
            SDL_PrivateJoystickAxis(joystick, (Uint8) i, (Sint16) value);
slouken@1895
   353
        }
slouken@1895
   354
    }
slouken@0
   355
slouken@1895
   356
    /* joystick button events */
slouken@1895
   357
    if (joyinfo.dwFlags & JOY_RETURNBUTTONS) {
slouken@1895
   358
        for (i = 0; i < joystick->nbuttons; ++i) {
slouken@1895
   359
            if (joyinfo.dwButtons & JOY_BUTTON_FLAG(i)) {
slouken@10745
   360
                SDL_PrivateJoystickButton(joystick, (Uint8) i, SDL_PRESSED);
slouken@1895
   361
            } else {
slouken@10745
   362
                SDL_PrivateJoystickButton(joystick, (Uint8) i, SDL_RELEASED);
slouken@1895
   363
            }
slouken@1895
   364
        }
slouken@1895
   365
    }
slouken@0
   366
slouken@1895
   367
    /* joystick hat events */
slouken@1895
   368
    if (joyinfo.dwFlags & JOY_RETURNPOV) {
slouken@1895
   369
        Uint8 pos;
slouken@0
   370
slouken@1895
   371
        pos = TranslatePOV(joyinfo.dwPOV);
slouken@10745
   372
        SDL_PrivateJoystickHat(joystick, 0, pos);
slouken@1895
   373
    }
slouken@0
   374
}
slouken@0
   375
slouken@0
   376
/* Function to close a joystick after use */
slouken@1895
   377
void
slouken@1895
   378
SDL_SYS_JoystickClose(SDL_Joystick * joystick)
slouken@0
   379
{
slouken@7719
   380
    SDL_free(joystick->hwdata);
slouken@0
   381
}
slouken@0
   382
slouken@0
   383
/* Function to perform any system-specific joystick related cleanup */
slouken@1895
   384
void
slouken@1895
   385
SDL_SYS_JoystickQuit(void)
slouken@0
   386
{
slouken@1895
   387
    int i;
slouken@1895
   388
    for (i = 0; i < MAX_JOYSTICKS; i++) {
slouken@7719
   389
        SDL_free(SYS_JoystickName[i]);
slouken@7719
   390
        SYS_JoystickName[i] = NULL;
slouken@1895
   391
    }
slouken@0
   392
}
slouken@0
   393
slouken@6738
   394
SDL_JoystickGUID SDL_SYS_JoystickGetDeviceGUID( int device_index )
slouken@6698
   395
{
slouken@6738
   396
    SDL_JoystickGUID guid;
slouken@7191
   397
    /* the GUID is just the first 16 chars of the name for now */
slouken@6707
   398
    const char *name = SDL_SYS_JoystickNameForDeviceIndex( device_index );
slouken@6698
   399
    SDL_zero( guid );
slouken@6698
   400
    SDL_memcpy( &guid, name, SDL_min( sizeof(guid), SDL_strlen( name ) ) );
slouken@6698
   401
    return guid;
slouken@6698
   402
}
slouken@6698
   403
slouken@6738
   404
SDL_JoystickGUID SDL_SYS_JoystickGetGUID(SDL_Joystick * joystick)
slouken@6698
   405
{
slouken@6738
   406
    SDL_JoystickGUID guid;
slouken@7191
   407
    /* the GUID is just the first 16 chars of the name for now */
slouken@6698
   408
    const char *name = joystick->name;
slouken@6698
   409
    SDL_zero( guid );
slouken@6698
   410
    SDL_memcpy( &guid, name, SDL_min( sizeof(guid), SDL_strlen( name ) ) );
slouken@6698
   411
    return guid;
slouken@6698
   412
}
slouken@6698
   413
slouken@0
   414
slouken@0
   415
/* implementation functions */
slouken@1895
   416
void
slouken@1895
   417
SetMMerror(char *function, int code)
slouken@0
   418
{
slouken@1895
   419
    static char *error;
slouken@1895
   420
    static char errbuf[1024];
slouken@0
   421
slouken@1895
   422
    errbuf[0] = 0;
slouken@1895
   423
    switch (code) {
slouken@1895
   424
    case MMSYSERR_NODRIVER:
slouken@1895
   425
        error = "Joystick driver not present";
slouken@1895
   426
        break;
slouken@1895
   427
slouken@1895
   428
    case MMSYSERR_INVALPARAM:
slouken@1895
   429
    case JOYERR_PARMS:
slouken@1895
   430
        error = "Invalid parameter(s)";
slouken@1895
   431
        break;
slouken@1895
   432
slouken@1895
   433
    case MMSYSERR_BADDEVICEID:
slouken@1895
   434
        error = "Bad device ID";
slouken@1895
   435
        break;
slouken@0
   436
slouken@1895
   437
    case JOYERR_UNPLUGGED:
slouken@1895
   438
        error = "Joystick not attached";
slouken@1895
   439
        break;
slouken@0
   440
slouken@1895
   441
    case JOYERR_NOCANDO:
slouken@1895
   442
        error = "Can't capture joystick input";
slouken@1895
   443
        break;
slouken@0
   444
slouken@1895
   445
    default:
slouken@1895
   446
        SDL_snprintf(errbuf, SDL_arraysize(errbuf),
slouken@1895
   447
                     "%s: Unknown Multimedia system error: 0x%x",
slouken@1895
   448
                     function, code);
slouken@1895
   449
        break;
slouken@1895
   450
    }
slouken@0
   451
slouken@1895
   452
    if (!errbuf[0]) {
slouken@1895
   453
        SDL_snprintf(errbuf, SDL_arraysize(errbuf), "%s: %s", function,
slouken@1895
   454
                     error);
slouken@1895
   455
    }
slouken@1895
   456
    SDL_SetError("%s", errbuf);
slouken@0
   457
}
slouken@1635
   458
slouken@1635
   459
#endif /* SDL_JOYSTICK_WINMM */
slouken@6707
   460
slouken@1895
   461
/* vi: set ts=4 sw=4 expandtab: */