2000-11-05 20:25:02 +00:00
|
|
|
/* DirectInput Device
|
|
|
|
*
|
|
|
|
* Copyright 1998 Marcus Meissner
|
|
|
|
* Copyright 1998,1999 Lionel Ulmer
|
|
|
|
*
|
2002-03-09 23:29:33 +00:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the Free Software
|
2006-05-18 12:49:52 +00:00
|
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
|
2000-11-05 20:25:02 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/* This file contains all the Device specific functions that can be used as stubs
|
|
|
|
by real device implementations.
|
|
|
|
|
|
|
|
It also contains all the helper functions.
|
|
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
|
2003-09-05 23:08:26 +00:00
|
|
|
#include <stdarg.h>
|
2001-01-26 20:43:40 +00:00
|
|
|
#include <string.h>
|
2002-03-09 23:29:33 +00:00
|
|
|
#include "wine/debug.h"
|
2003-06-16 20:22:13 +00:00
|
|
|
#include "wine/unicode.h"
|
2003-09-05 23:08:26 +00:00
|
|
|
#include "windef.h"
|
2000-11-05 20:25:02 +00:00
|
|
|
#include "winbase.h"
|
2007-09-25 01:34:27 +00:00
|
|
|
#include "winreg.h"
|
2006-03-18 18:26:37 +00:00
|
|
|
#include "winuser.h"
|
2000-11-05 20:25:02 +00:00
|
|
|
#include "winerror.h"
|
|
|
|
#include "dinput.h"
|
|
|
|
#include "device_private.h"
|
2006-03-18 18:26:37 +00:00
|
|
|
#include "dinput_private.h"
|
2000-11-05 20:25:02 +00:00
|
|
|
|
2002-03-09 23:29:33 +00:00
|
|
|
WINE_DEFAULT_DEBUG_CHANNEL(dinput);
|
2000-11-05 20:25:02 +00:00
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Various debugging tools
|
|
|
|
*/
|
|
|
|
void _dump_cooperativelevel_DI(DWORD dwFlags) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (TRACE_ON(dinput)) {
|
2004-09-08 01:23:57 +00:00
|
|
|
unsigned int i;
|
2004-06-02 00:36:54 +00:00
|
|
|
static const struct {
|
|
|
|
DWORD mask;
|
|
|
|
const char *name;
|
|
|
|
} flags[] = {
|
|
|
|
#define FE(x) { x, #x}
|
|
|
|
FE(DISCL_BACKGROUND),
|
|
|
|
FE(DISCL_EXCLUSIVE),
|
|
|
|
FE(DISCL_FOREGROUND),
|
2006-07-28 14:13:21 +00:00
|
|
|
FE(DISCL_NONEXCLUSIVE),
|
|
|
|
FE(DISCL_NOWINKEY)
|
2000-11-05 20:25:02 +00:00
|
|
|
#undef FE
|
2004-06-02 00:36:54 +00:00
|
|
|
};
|
|
|
|
for (i = 0; i < (sizeof(flags) / sizeof(flags[0])); i++)
|
|
|
|
if (flags[i].mask & dwFlags)
|
|
|
|
DPRINTF("%s ",flags[i].name);
|
|
|
|
DPRINTF("\n");
|
|
|
|
}
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void _dump_EnumObjects_flags(DWORD dwFlags) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (TRACE_ON(dinput)) {
|
2004-09-08 01:23:57 +00:00
|
|
|
unsigned int i;
|
2004-06-02 00:36:54 +00:00
|
|
|
DWORD type, instance;
|
|
|
|
static const struct {
|
|
|
|
DWORD mask;
|
|
|
|
const char *name;
|
|
|
|
} flags[] = {
|
|
|
|
#define FE(x) { x, #x}
|
|
|
|
FE(DIDFT_RELAXIS),
|
|
|
|
FE(DIDFT_ABSAXIS),
|
|
|
|
FE(DIDFT_PSHBUTTON),
|
|
|
|
FE(DIDFT_TGLBUTTON),
|
|
|
|
FE(DIDFT_POV),
|
|
|
|
FE(DIDFT_COLLECTION),
|
|
|
|
FE(DIDFT_NODATA),
|
|
|
|
FE(DIDFT_FFACTUATOR),
|
|
|
|
FE(DIDFT_FFEFFECTTRIGGER),
|
2005-05-05 09:49:54 +00:00
|
|
|
FE(DIDFT_OUTPUT),
|
|
|
|
FE(DIDFT_VENDORDEFINED),
|
|
|
|
FE(DIDFT_ALIAS),
|
|
|
|
FE(DIDFT_OPTIONAL)
|
2000-11-05 20:25:02 +00:00
|
|
|
#undef FE
|
2004-06-02 00:36:54 +00:00
|
|
|
};
|
|
|
|
type = (dwFlags & 0xFF0000FF);
|
|
|
|
instance = ((dwFlags >> 8) & 0xFFFF);
|
|
|
|
DPRINTF("Type:");
|
|
|
|
if (type == DIDFT_ALL) {
|
|
|
|
DPRINTF(" DIDFT_ALL");
|
|
|
|
} else {
|
|
|
|
for (i = 0; i < (sizeof(flags) / sizeof(flags[0])); i++) {
|
|
|
|
if (flags[i].mask & type) {
|
|
|
|
type &= ~flags[i].mask;
|
|
|
|
DPRINTF(" %s",flags[i].name);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (type) {
|
2006-10-07 23:55:40 +00:00
|
|
|
DPRINTF(" (unhandled: %08x)", type);
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
DPRINTF(" / Instance: ");
|
|
|
|
if (instance == ((DIDFT_ANYINSTANCE >> 8) & 0xFFFF)) {
|
|
|
|
DPRINTF("DIDFT_ANYINSTANCE");
|
|
|
|
} else {
|
2006-10-07 23:55:40 +00:00
|
|
|
DPRINTF("%3d", instance);
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
|
|
|
}
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2004-08-31 18:51:23 +00:00
|
|
|
void _dump_DIPROPHEADER(LPCDIPROPHEADER diph) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (TRACE_ON(dinput)) {
|
2006-10-07 23:55:40 +00:00
|
|
|
DPRINTF(" - dwObj = 0x%08x\n", diph->dwObj);
|
2004-06-02 00:36:54 +00:00
|
|
|
DPRINTF(" - dwHow = %s\n",
|
|
|
|
((diph->dwHow == DIPH_DEVICE) ? "DIPH_DEVICE" :
|
|
|
|
((diph->dwHow == DIPH_BYOFFSET) ? "DIPH_BYOFFSET" :
|
|
|
|
((diph->dwHow == DIPH_BYID)) ? "DIPH_BYID" : "unknown")));
|
|
|
|
}
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2007-04-24 06:45:32 +00:00
|
|
|
void _dump_OBJECTINSTANCEA(const DIDEVICEOBJECTINSTANCEA *ddoi) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (TRACE_ON(dinput)) {
|
2006-10-07 23:55:40 +00:00
|
|
|
DPRINTF(" - enumerating : %s ('%s') - %2d - 0x%08x - %s\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
debugstr_guid(&ddoi->guidType), _dump_dinput_GUID(&ddoi->guidType), ddoi->dwOfs, ddoi->dwType, ddoi->tszName);
|
|
|
|
}
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2007-04-24 06:45:32 +00:00
|
|
|
void _dump_OBJECTINSTANCEW(const DIDEVICEOBJECTINSTANCEW *ddoi) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (TRACE_ON(dinput)) {
|
2006-10-07 23:55:40 +00:00
|
|
|
DPRINTF(" - enumerating : %s ('%s'), - %2d - 0x%08x - %s\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
debugstr_guid(&ddoi->guidType), _dump_dinput_GUID(&ddoi->guidType), ddoi->dwOfs, ddoi->dwType, debugstr_w(ddoi->tszName));
|
|
|
|
}
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
/* This function is a helper to convert a GUID into any possible DInput GUID out there */
|
|
|
|
const char *_dump_dinput_GUID(const GUID *guid) {
|
2004-09-08 01:23:57 +00:00
|
|
|
unsigned int i;
|
2004-06-02 00:36:54 +00:00
|
|
|
static const struct {
|
|
|
|
const GUID *guid;
|
|
|
|
const char *name;
|
|
|
|
} guids[] = {
|
|
|
|
#define FE(x) { &x, #x}
|
|
|
|
FE(GUID_XAxis),
|
|
|
|
FE(GUID_YAxis),
|
|
|
|
FE(GUID_ZAxis),
|
|
|
|
FE(GUID_RxAxis),
|
|
|
|
FE(GUID_RyAxis),
|
|
|
|
FE(GUID_RzAxis),
|
|
|
|
FE(GUID_Slider),
|
|
|
|
FE(GUID_Button),
|
|
|
|
FE(GUID_Key),
|
|
|
|
FE(GUID_POV),
|
|
|
|
FE(GUID_Unknown),
|
|
|
|
FE(GUID_SysMouse),
|
|
|
|
FE(GUID_SysKeyboard),
|
|
|
|
FE(GUID_Joystick),
|
|
|
|
FE(GUID_ConstantForce),
|
|
|
|
FE(GUID_RampForce),
|
|
|
|
FE(GUID_Square),
|
|
|
|
FE(GUID_Sine),
|
|
|
|
FE(GUID_Triangle),
|
|
|
|
FE(GUID_SawtoothUp),
|
|
|
|
FE(GUID_SawtoothDown),
|
|
|
|
FE(GUID_Spring),
|
|
|
|
FE(GUID_Damper),
|
|
|
|
FE(GUID_Inertia),
|
|
|
|
FE(GUID_Friction),
|
|
|
|
FE(GUID_CustomForce)
|
|
|
|
#undef FE
|
|
|
|
};
|
|
|
|
if (guid == NULL)
|
|
|
|
return "null GUID";
|
|
|
|
for (i = 0; i < (sizeof(guids) / sizeof(guids[0])); i++) {
|
|
|
|
if (IsEqualGUID(guids[i].guid, guid)) {
|
|
|
|
return guids[i].name;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
}
|
2004-06-02 00:36:54 +00:00
|
|
|
return "Unknown GUID";
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
void _dump_DIDATAFORMAT(const DIDATAFORMAT *df) {
|
2004-09-08 01:23:57 +00:00
|
|
|
unsigned int i;
|
2000-11-05 20:25:02 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE("Dumping DIDATAFORMAT structure:\n");
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" - dwSize: %d\n", df->dwSize);
|
2004-06-02 00:36:54 +00:00
|
|
|
if (df->dwSize != sizeof(DIDATAFORMAT)) {
|
2006-10-07 23:55:40 +00:00
|
|
|
WARN("Non-standard DIDATAFORMAT structure size %d\n", df->dwSize);
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" - dwObjsize: %d\n", df->dwObjSize);
|
2004-06-02 00:36:54 +00:00
|
|
|
if (df->dwObjSize != sizeof(DIOBJECTDATAFORMAT)) {
|
2006-10-07 23:55:40 +00:00
|
|
|
WARN("Non-standard DIOBJECTDATAFORMAT structure size %d\n", df->dwObjSize);
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" - dwFlags: 0x%08x (", df->dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
switch (df->dwFlags) {
|
|
|
|
case DIDF_ABSAXIS: TRACE("DIDF_ABSAXIS"); break;
|
|
|
|
case DIDF_RELAXIS: TRACE("DIDF_RELAXIS"); break;
|
|
|
|
default: TRACE("unknown"); break;
|
|
|
|
}
|
|
|
|
TRACE(")\n");
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" - dwDataSize: %d\n", df->dwDataSize);
|
|
|
|
TRACE(" - dwNumObjs: %d\n", df->dwNumObjs);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
for (i = 0; i < df->dwNumObjs; i++) {
|
|
|
|
TRACE(" - Object %d:\n", i);
|
|
|
|
TRACE(" * GUID: %s ('%s')\n", debugstr_guid(df->rgodf[i].pguid), _dump_dinput_GUID(df->rgodf[i].pguid));
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" * dwOfs: %d\n", df->rgodf[i].dwOfs);
|
|
|
|
TRACE(" * dwType: 0x%08x\n", df->rgodf[i].dwType);
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE(" "); _dump_EnumObjects_flags(df->rgodf[i].dwType); TRACE("\n");
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" * dwFlags: 0x%08x\n", df->rgodf[i].dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2007-09-25 01:34:32 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* Get the default and the app-specific config keys.
|
|
|
|
*/
|
|
|
|
BOOL get_app_key(HKEY *defkey, HKEY *appkey)
|
|
|
|
{
|
|
|
|
char buffer[MAX_PATH+16];
|
|
|
|
DWORD len;
|
|
|
|
|
|
|
|
*appkey = 0;
|
|
|
|
|
|
|
|
/* @@ Wine registry key: HKCU\Software\Wine\DirectInput */
|
|
|
|
if (RegOpenKeyA(HKEY_CURRENT_USER, "Software\\Wine\\DirectInput", defkey))
|
|
|
|
*defkey = 0;
|
|
|
|
|
|
|
|
len = GetModuleFileNameA(0, buffer, MAX_PATH);
|
|
|
|
if (len && len < MAX_PATH)
|
|
|
|
{
|
|
|
|
HKEY tmpkey;
|
|
|
|
|
|
|
|
/* @@ Wine registry key: HKCU\Software\Wine\AppDefaults\app.exe\DirectInput */
|
|
|
|
if (!RegOpenKeyA(HKEY_CURRENT_USER, "Software\\Wine\\AppDefaults", &tmpkey))
|
|
|
|
{
|
|
|
|
char *p, *appname = buffer;
|
|
|
|
if ((p = strrchr(appname, '/'))) appname = p + 1;
|
|
|
|
if ((p = strrchr(appname, '\\'))) appname = p + 1;
|
|
|
|
strcat(appname, "\\DirectInput");
|
|
|
|
|
2007-09-29 16:23:11 +00:00
|
|
|
if (RegOpenKeyA(tmpkey, appname, appkey)) *appkey = 0;
|
2007-09-25 01:34:32 +00:00
|
|
|
RegCloseKey(tmpkey);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return *defkey || *appkey;
|
|
|
|
}
|
|
|
|
|
2007-09-25 01:34:27 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* Get a config key from either the app-specific or the default config
|
|
|
|
*/
|
|
|
|
DWORD get_config_key( HKEY defkey, HKEY appkey, const char *name,
|
|
|
|
char *buffer, DWORD size )
|
|
|
|
{
|
|
|
|
if (appkey && !RegQueryValueExA( appkey, name, 0, NULL, (LPBYTE)buffer, &size ))
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
if (defkey && !RegQueryValueExA( defkey, name, 0, NULL, (LPBYTE)buffer, &size ))
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
return ERROR_FILE_NOT_FOUND;
|
|
|
|
}
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
/* Conversion between internal data buffer and external data buffer */
|
2007-04-24 06:45:32 +00:00
|
|
|
void fill_DataFormat(void *out, const void *in, const DataFormat *df) {
|
2004-06-02 00:36:54 +00:00
|
|
|
int i;
|
2006-09-08 15:35:27 +00:00
|
|
|
const char *in_c = in;
|
2004-06-02 00:36:54 +00:00
|
|
|
char *out_c = (char *) out;
|
2006-09-08 15:35:27 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
if (df->dt == NULL) {
|
|
|
|
/* This means that the app uses Wine's internal data format */
|
|
|
|
memcpy(out, in, df->internal_format_size);
|
|
|
|
} else {
|
|
|
|
for (i = 0; i < df->size; i++) {
|
|
|
|
if (df->dt[i].offset_in >= 0) {
|
|
|
|
switch (df->dt[i].size) {
|
|
|
|
case 1:
|
|
|
|
TRACE("Copying (c) to %d from %d (value %d)\n",
|
2006-09-08 15:35:27 +00:00
|
|
|
df->dt[i].offset_out, df->dt[i].offset_in, *(in_c + df->dt[i].offset_in));
|
|
|
|
*(out_c + df->dt[i].offset_out) = *(in_c + df->dt[i].offset_in);
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
2006-09-08 15:35:27 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
case 2:
|
|
|
|
TRACE("Copying (s) to %d from %d (value %d)\n",
|
2006-09-08 15:35:27 +00:00
|
|
|
df->dt[i].offset_out, df->dt[i].offset_in, *((const short *)(in_c + df->dt[i].offset_in)));
|
|
|
|
*((short *)(out_c + df->dt[i].offset_out)) = *((const short *)(in_c + df->dt[i].offset_in));
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
2006-09-08 15:35:27 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
case 4:
|
|
|
|
TRACE("Copying (i) to %d from %d (value %d)\n",
|
2006-09-08 15:35:27 +00:00
|
|
|
df->dt[i].offset_out, df->dt[i].offset_in, *((const int *)(in_c + df->dt[i].offset_in)));
|
|
|
|
*((int *)(out_c + df->dt[i].offset_out)) = *((const int *)(in_c + df->dt[i].offset_in));
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
2006-09-08 15:35:27 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
default:
|
|
|
|
memcpy((out_c + df->dt[i].offset_out), (in_c + df->dt[i].offset_in), df->dt[i].size);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
switch (df->dt[i].size) {
|
|
|
|
case 1:
|
|
|
|
TRACE("Copying (c) to %d default value %d\n",
|
|
|
|
df->dt[i].offset_out, df->dt[i].value);
|
2006-09-08 15:35:27 +00:00
|
|
|
*(out_c + df->dt[i].offset_out) = (char) df->dt[i].value;
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 2:
|
|
|
|
TRACE("Copying (s) to %d default value %d\n",
|
|
|
|
df->dt[i].offset_out, df->dt[i].value);
|
|
|
|
*((short *) (out_c + df->dt[i].offset_out)) = (short) df->dt[i].value;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 4:
|
|
|
|
TRACE("Copying (i) to %d default value %d\n",
|
|
|
|
df->dt[i].offset_out, df->dt[i].value);
|
|
|
|
*((int *) (out_c + df->dt[i].offset_out)) = (int) df->dt[i].value;
|
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
2006-07-13 21:06:17 +00:00
|
|
|
memset((out_c + df->dt[i].offset_out), 0, df->dt[i].size);
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2004-09-02 20:09:54 +00:00
|
|
|
void release_DataFormat(DataFormat * format)
|
|
|
|
{
|
2006-12-12 15:57:54 +00:00
|
|
|
TRACE("Deleting DataFormat: %p\n", format);
|
2004-09-02 20:09:54 +00:00
|
|
|
|
|
|
|
HeapFree(GetProcessHeap(), 0, format->dt);
|
2006-12-12 15:57:54 +00:00
|
|
|
format->dt = NULL;
|
|
|
|
HeapFree(GetProcessHeap(), 0, format->offsets);
|
|
|
|
format->offsets = NULL;
|
2006-12-12 15:58:02 +00:00
|
|
|
HeapFree(GetProcessHeap(), 0, format->user_df);
|
|
|
|
format->user_df = NULL;
|
2004-09-02 20:09:54 +00:00
|
|
|
}
|
|
|
|
|
2007-01-04 06:04:24 +00:00
|
|
|
inline LPDIOBJECTDATAFORMAT dataformat_to_odf(LPCDIDATAFORMAT df, int idx)
|
|
|
|
{
|
|
|
|
if (idx < 0 || idx >= df->dwNumObjs) return NULL;
|
|
|
|
return (LPDIOBJECTDATAFORMAT)((LPBYTE)df->rgodf + idx * df->dwObjSize);
|
|
|
|
}
|
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
HRESULT create_DataFormat(LPCDIDATAFORMAT asked_format, DataFormat *format)
|
2006-12-10 21:15:20 +00:00
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
DataTransform *dt;
|
2004-09-08 01:23:57 +00:00
|
|
|
unsigned int i, j;
|
2004-06-02 00:36:54 +00:00
|
|
|
int same = 1;
|
|
|
|
int *done;
|
|
|
|
int index = 0;
|
2004-09-06 21:26:03 +00:00
|
|
|
DWORD next = 0;
|
2006-12-12 15:58:40 +00:00
|
|
|
|
|
|
|
if (!format->wine_df) return DIERR_INVALIDPARAM;
|
2006-12-12 15:57:54 +00:00
|
|
|
done = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, asked_format->dwNumObjs * sizeof(int));
|
2005-03-24 21:01:35 +00:00
|
|
|
dt = HeapAlloc(GetProcessHeap(), 0, asked_format->dwNumObjs * sizeof(DataTransform));
|
2006-12-12 15:57:54 +00:00
|
|
|
if (!dt || !done) goto failed;
|
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
if (!(format->offsets = HeapAlloc(GetProcessHeap(), 0, format->wine_df->dwNumObjs * sizeof(int))))
|
2006-12-12 15:57:54 +00:00
|
|
|
goto failed;
|
|
|
|
|
2006-12-12 15:58:02 +00:00
|
|
|
if (!(format->user_df = HeapAlloc(GetProcessHeap(), 0, asked_format->dwSize)))
|
|
|
|
goto failed;
|
|
|
|
memcpy(format->user_df, asked_format, asked_format->dwSize);
|
|
|
|
|
2005-11-10 12:14:56 +00:00
|
|
|
TRACE("Creating DataTransform :\n");
|
2004-06-02 00:36:54 +00:00
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
for (i = 0; i < format->wine_df->dwNumObjs; i++)
|
|
|
|
{
|
2006-12-12 15:57:54 +00:00
|
|
|
format->offsets[i] = -1;
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
for (j = 0; j < asked_format->dwNumObjs; j++) {
|
|
|
|
if (done[j] == 1)
|
|
|
|
continue;
|
|
|
|
|
|
|
|
if (/* Check if the application either requests any GUID and if not, it if matches
|
|
|
|
* the GUID of the Wine object.
|
|
|
|
*/
|
|
|
|
((asked_format->rgodf[j].pguid == NULL) ||
|
2006-12-12 15:58:40 +00:00
|
|
|
(format->wine_df->rgodf[i].pguid == NULL) ||
|
|
|
|
(IsEqualGUID(format->wine_df->rgodf[i].pguid, asked_format->rgodf[j].pguid)))
|
2004-06-02 00:36:54 +00:00
|
|
|
&&
|
|
|
|
(/* Then check if it accepts any instance id, and if not, if it matches Wine's
|
|
|
|
* instance id.
|
|
|
|
*/
|
2006-12-20 11:28:58 +00:00
|
|
|
((asked_format->rgodf[j].dwType & DIDFT_INSTANCEMASK) == DIDFT_ANYINSTANCE) ||
|
2005-05-05 09:49:54 +00:00
|
|
|
(DIDFT_GETINSTANCE(asked_format->rgodf[j].dwType) == 0x00FF) || /* This is mentionned in no DX docs, but it works fine - tested on WinXP */
|
2006-12-12 15:58:40 +00:00
|
|
|
(DIDFT_GETINSTANCE(asked_format->rgodf[j].dwType) == DIDFT_GETINSTANCE(format->wine_df->rgodf[i].dwType)))
|
2005-05-05 09:49:54 +00:00
|
|
|
&&
|
|
|
|
( /* Then if the asked type matches the one Wine provides */
|
2006-12-12 15:58:40 +00:00
|
|
|
DIDFT_GETTYPE(asked_format->rgodf[j].dwType) & format->wine_df->rgodf[i].dwType))
|
2006-12-10 06:56:58 +00:00
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
done[j] = 1;
|
|
|
|
|
2005-11-10 12:14:56 +00:00
|
|
|
TRACE("Matching :\n");
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE(" - Asked (%d) :\n", j);
|
|
|
|
TRACE(" * GUID: %s ('%s')\n",
|
|
|
|
debugstr_guid(asked_format->rgodf[j].pguid),
|
|
|
|
_dump_dinput_GUID(asked_format->rgodf[j].pguid));
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" * Offset: %3d\n", asked_format->rgodf[j].dwOfs);
|
|
|
|
TRACE(" * dwType: %08x\n", asked_format->rgodf[j].dwType);
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE(" "); _dump_EnumObjects_flags(asked_format->rgodf[j].dwType); TRACE("\n");
|
|
|
|
|
2005-05-10 13:17:03 +00:00
|
|
|
TRACE(" - Wine (%d) :\n", i);
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE(" * GUID: %s ('%s')\n",
|
2006-12-12 15:58:40 +00:00
|
|
|
debugstr_guid(format->wine_df->rgodf[i].pguid),
|
|
|
|
_dump_dinput_GUID(format->wine_df->rgodf[i].pguid));
|
|
|
|
TRACE(" * Offset: %3d\n", format->wine_df->rgodf[i].dwOfs);
|
|
|
|
TRACE(" * dwType: %08x\n", format->wine_df->rgodf[i].dwType);
|
|
|
|
TRACE(" "); _dump_EnumObjects_flags(format->wine_df->rgodf[i].dwType); TRACE("\n");
|
2004-06-02 00:36:54 +00:00
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
if (format->wine_df->rgodf[i].dwType & DIDFT_BUTTON)
|
2004-06-02 00:36:54 +00:00
|
|
|
dt[index].size = sizeof(BYTE);
|
|
|
|
else
|
|
|
|
dt[index].size = sizeof(DWORD);
|
2006-12-12 15:58:40 +00:00
|
|
|
dt[index].offset_in = format->wine_df->rgodf[i].dwOfs;
|
2006-12-11 00:10:34 +00:00
|
|
|
dt[index].offset_out = asked_format->rgodf[j].dwOfs;
|
2006-12-12 15:57:54 +00:00
|
|
|
format->offsets[i] = asked_format->rgodf[j].dwOfs;
|
2004-06-02 00:36:54 +00:00
|
|
|
dt[index].value = 0;
|
2004-09-06 21:26:03 +00:00
|
|
|
next = next + dt[index].size;
|
2004-06-02 00:36:54 +00:00
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
if (format->wine_df->rgodf[i].dwOfs != dt[index].offset_out)
|
2004-06-02 00:36:54 +00:00
|
|
|
same = 0;
|
|
|
|
|
2004-09-06 21:26:03 +00:00
|
|
|
index++;
|
2004-06-02 00:36:54 +00:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (j == asked_format->dwNumObjs)
|
|
|
|
same = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
TRACE("Setting to default value :\n");
|
2000-11-05 20:25:02 +00:00
|
|
|
for (j = 0; j < asked_format->dwNumObjs; j++) {
|
2004-06-02 00:36:54 +00:00
|
|
|
if (done[j] == 0) {
|
|
|
|
TRACE(" - Asked (%d) :\n", j);
|
|
|
|
TRACE(" * GUID: %s ('%s')\n",
|
|
|
|
debugstr_guid(asked_format->rgodf[j].pguid),
|
|
|
|
_dump_dinput_GUID(asked_format->rgodf[j].pguid));
|
2006-10-07 23:55:40 +00:00
|
|
|
TRACE(" * Offset: %3d\n", asked_format->rgodf[j].dwOfs);
|
|
|
|
TRACE(" * dwType: %08x\n", asked_format->rgodf[j].dwType);
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE(" "); _dump_EnumObjects_flags(asked_format->rgodf[j].dwType); TRACE("\n");
|
|
|
|
|
|
|
|
if (asked_format->rgodf[j].dwType & DIDFT_BUTTON)
|
|
|
|
dt[index].size = sizeof(BYTE);
|
|
|
|
else
|
|
|
|
dt[index].size = sizeof(DWORD);
|
|
|
|
dt[index].offset_in = -1;
|
|
|
|
dt[index].offset_out = asked_format->rgodf[j].dwOfs;
|
|
|
|
dt[index].value = 0;
|
|
|
|
index++;
|
|
|
|
|
|
|
|
same = 0;
|
|
|
|
}
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2004-06-02 00:36:54 +00:00
|
|
|
|
2006-12-12 15:58:40 +00:00
|
|
|
format->internal_format_size = format->wine_df->dwDataSize;
|
2006-12-12 15:57:54 +00:00
|
|
|
format->size = index;
|
2004-06-02 00:36:54 +00:00
|
|
|
if (same) {
|
|
|
|
HeapFree(GetProcessHeap(), 0, dt);
|
2006-12-12 15:57:54 +00:00
|
|
|
dt = NULL;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2006-12-12 15:57:54 +00:00
|
|
|
format->dt = dt;
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
HeapFree(GetProcessHeap(), 0, done);
|
2006-12-10 21:15:20 +00:00
|
|
|
|
2006-12-12 15:57:54 +00:00
|
|
|
return DI_OK;
|
|
|
|
|
|
|
|
failed:
|
|
|
|
HeapFree(GetProcessHeap(), 0, done);
|
|
|
|
HeapFree(GetProcessHeap(), 0, dt);
|
|
|
|
format->dt = NULL;
|
|
|
|
HeapFree(GetProcessHeap(), 0, format->offsets);
|
|
|
|
format->offsets = NULL;
|
2006-12-12 15:58:02 +00:00
|
|
|
HeapFree(GetProcessHeap(), 0, format->user_df);
|
|
|
|
format->user_df = NULL;
|
2006-12-12 15:57:54 +00:00
|
|
|
|
|
|
|
return DIERR_OUTOFMEMORY;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2006-12-10 21:15:29 +00:00
|
|
|
/* find an object by it's offset in a data format */
|
2007-04-24 06:45:32 +00:00
|
|
|
static int offset_to_object(const DataFormat *df, int offset)
|
2006-12-10 21:15:29 +00:00
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
2007-01-09 20:44:54 +00:00
|
|
|
if (!df->offsets) return -1;
|
|
|
|
|
|
|
|
for (i = 0; i < df->wine_df->dwNumObjs; i++)
|
|
|
|
if (df->offsets[i] == offset) return i;
|
2006-12-10 21:15:29 +00:00
|
|
|
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
2007-08-05 18:18:26 +00:00
|
|
|
int id_to_object(LPCDIDATAFORMAT df, int id)
|
2006-12-10 21:15:29 +00:00
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
2007-01-06 00:14:55 +00:00
|
|
|
id &= 0x00ffffff;
|
2006-12-10 21:15:29 +00:00
|
|
|
for (i = 0; i < df->dwNumObjs; i++)
|
2007-01-06 00:14:55 +00:00
|
|
|
if ((dataformat_to_odf(df, i)->dwType & 0x00ffffff) == id)
|
2006-12-10 21:15:29 +00:00
|
|
|
return i;
|
|
|
|
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
2007-04-24 06:45:32 +00:00
|
|
|
int id_to_offset(const DataFormat *df, int id)
|
2007-01-06 00:14:55 +00:00
|
|
|
{
|
|
|
|
int obj = id_to_object(df->wine_df, id);
|
|
|
|
|
|
|
|
return obj >= 0 && df->offsets ? df->offsets[obj] : -1;
|
|
|
|
}
|
|
|
|
|
2007-04-24 06:45:32 +00:00
|
|
|
int find_property(const DataFormat *df, LPCDIPROPHEADER ph)
|
2006-12-10 21:15:29 +00:00
|
|
|
{
|
|
|
|
switch (ph->dwHow)
|
|
|
|
{
|
2007-01-09 20:44:54 +00:00
|
|
|
case DIPH_BYID: return id_to_object(df->wine_df, ph->dwObj);
|
|
|
|
case DIPH_BYOFFSET: return offset_to_object(df, ph->dwObj);
|
2006-12-10 21:15:29 +00:00
|
|
|
}
|
|
|
|
FIXME("Unhandled ph->dwHow=='%04X'\n", (unsigned int)ph->dwHow);
|
|
|
|
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
BOOL DIEnumDevicesCallbackAtoW(LPCDIDEVICEOBJECTINSTANCEA lpddi, LPVOID lpvRef) {
|
2004-06-02 00:36:54 +00:00
|
|
|
DIDEVICEOBJECTINSTANCEW ddtmp;
|
|
|
|
device_enumobjects_AtoWcb_data* data;
|
|
|
|
|
|
|
|
data = (device_enumobjects_AtoWcb_data*) lpvRef;
|
|
|
|
|
2005-04-25 10:48:38 +00:00
|
|
|
memset(&ddtmp, 0, sizeof(ddtmp));
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
ddtmp.dwSize = sizeof(DIDEVICEINSTANCEW);
|
|
|
|
ddtmp.guidType = lpddi->guidType;
|
|
|
|
ddtmp.dwOfs = lpddi->dwOfs;
|
|
|
|
ddtmp.dwType = lpddi->dwType;
|
|
|
|
ddtmp.dwFlags = lpddi->dwFlags;
|
|
|
|
MultiByteToWideChar(CP_ACP, 0, lpddi->tszName, -1, ddtmp.tszName, MAX_PATH);
|
|
|
|
|
|
|
|
if (lpddi->dwSize == sizeof(DIDEVICEINSTANCEA)) {
|
|
|
|
/**
|
|
|
|
* if dwSize < sizeof(DIDEVICEINSTANCEA of DInput version >= 5)
|
|
|
|
* force feedback and other newer datas aren't available
|
|
|
|
*/
|
|
|
|
ddtmp.dwFFMaxForce = lpddi->dwFFMaxForce;
|
|
|
|
ddtmp.dwFFForceResolution = lpddi->dwFFForceResolution;
|
|
|
|
ddtmp.wCollectionNumber = lpddi->wCollectionNumber;
|
|
|
|
ddtmp.wDesignatorIndex = lpddi->wDesignatorIndex;
|
|
|
|
ddtmp.wUsagePage = lpddi->wUsagePage;
|
|
|
|
ddtmp.wUsage = lpddi->wUsage;
|
|
|
|
ddtmp.dwDimension = lpddi->dwDimension;
|
|
|
|
ddtmp.wExponent = lpddi->wExponent;
|
|
|
|
ddtmp.wReserved = lpddi->wReserved;
|
|
|
|
}
|
|
|
|
return data->lpCallBack(&ddtmp, data->lpvRef);
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* queue_event - add new event to the ring queue
|
|
|
|
*/
|
|
|
|
|
|
|
|
void queue_event(LPDIRECTINPUTDEVICE8A iface, int ofs, DWORD data, DWORD time, DWORD seq)
|
|
|
|
{
|
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
int next_pos;
|
|
|
|
|
2007-04-08 15:05:56 +00:00
|
|
|
/* Event is being set regardless of the queue state */
|
|
|
|
if (This->hEvent) SetEvent(This->hEvent);
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
if (!This->queue_len || This->overflow || ofs < 0) return;
|
|
|
|
|
|
|
|
next_pos = (This->queue_head + 1) % This->queue_len;
|
|
|
|
if (next_pos == This->queue_tail)
|
|
|
|
{
|
|
|
|
TRACE(" queue overflowed\n");
|
|
|
|
This->overflow = TRUE;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
TRACE(" queueing %d at offset %d (queue head %d / size %d)\n",
|
|
|
|
data, ofs, This->queue_head, This->queue_len);
|
|
|
|
|
|
|
|
This->data_queue[This->queue_head].dwOfs = ofs;
|
|
|
|
This->data_queue[This->queue_head].dwData = data;
|
|
|
|
This->data_queue[This->queue_head].dwTimeStamp = time;
|
|
|
|
This->data_queue[This->queue_head].dwSequence = seq;
|
|
|
|
This->queue_head = next_pos;
|
2007-01-07 07:14:56 +00:00
|
|
|
/* Send event if asked */
|
2006-12-04 17:54:05 +00:00
|
|
|
}
|
|
|
|
|
2006-12-01 17:54:42 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* Acquire
|
|
|
|
*/
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_Acquire(LPDIRECTINPUTDEVICE8A iface)
|
|
|
|
{
|
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2006-12-01 17:56:00 +00:00
|
|
|
HRESULT res;
|
2006-12-01 17:54:42 +00:00
|
|
|
|
2006-12-12 15:58:02 +00:00
|
|
|
if (!This->data_format.user_df) return DIERR_INVALIDPARAM;
|
2007-06-03 15:09:35 +00:00
|
|
|
if (This->dwCoopLevel & DISCL_FOREGROUND && This->win != GetForegroundWindow())
|
|
|
|
return DIERR_OTHERAPPHASPRIO;
|
2006-12-12 15:58:02 +00:00
|
|
|
|
2006-12-01 17:56:00 +00:00
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
res = This->acquired ? S_FALSE : DI_OK;
|
2006-12-01 17:54:42 +00:00
|
|
|
This->acquired = 1;
|
2006-12-04 17:54:05 +00:00
|
|
|
if (res == DI_OK)
|
2007-07-07 05:36:39 +00:00
|
|
|
{
|
2006-12-04 17:54:05 +00:00
|
|
|
This->queue_head = This->queue_tail = This->overflow = 0;
|
2007-07-07 05:36:39 +00:00
|
|
|
check_dinput_hooks(iface);
|
|
|
|
}
|
2006-12-01 17:56:00 +00:00
|
|
|
LeaveCriticalSection(&This->crit);
|
2006-12-01 17:54:42 +00:00
|
|
|
|
2006-12-01 17:56:00 +00:00
|
|
|
return res;
|
2006-12-01 17:54:42 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Unacquire
|
|
|
|
*/
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_Unacquire(LPDIRECTINPUTDEVICE8A iface)
|
|
|
|
{
|
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2006-12-01 17:56:00 +00:00
|
|
|
HRESULT res;
|
2006-12-01 17:54:42 +00:00
|
|
|
|
2006-12-01 17:56:00 +00:00
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
res = !This->acquired ? DI_NOEFFECT : DI_OK;
|
2006-12-01 17:54:42 +00:00
|
|
|
This->acquired = 0;
|
2007-07-07 05:36:39 +00:00
|
|
|
if (res == DI_OK)
|
|
|
|
check_dinput_hooks(iface);
|
2006-12-01 17:56:00 +00:00
|
|
|
LeaveCriticalSection(&This->crit);
|
2006-12-01 17:54:42 +00:00
|
|
|
|
2006-12-01 17:56:00 +00:00
|
|
|
return res;
|
2006-12-01 17:54:42 +00:00
|
|
|
}
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* IDirectInputDeviceA
|
|
|
|
*/
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SetDataFormat(
|
2006-12-12 15:58:02 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface, LPCDIDATAFORMAT df)
|
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2006-12-12 15:58:02 +00:00
|
|
|
HRESULT res = DI_OK;
|
|
|
|
|
|
|
|
if (!df) return E_POINTER;
|
|
|
|
TRACE("(%p) %p\n", This, df);
|
2004-06-02 00:36:54 +00:00
|
|
|
_dump_DIDATAFORMAT(df);
|
2006-12-12 15:58:02 +00:00
|
|
|
|
|
|
|
if (df->dwSize != sizeof(DIDATAFORMAT)) return DIERR_INVALIDPARAM;
|
|
|
|
if (This->acquired) return DIERR_ACQUIRED;
|
|
|
|
|
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
|
|
|
|
release_DataFormat(&This->data_format);
|
2006-12-12 15:58:40 +00:00
|
|
|
res = create_DataFormat(df, &This->data_format);
|
2006-12-12 15:58:02 +00:00
|
|
|
|
|
|
|
LeaveCriticalSection(&This->crit);
|
|
|
|
return res;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2006-10-15 17:30:07 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* SetCooperativeLevel
|
|
|
|
*
|
|
|
|
* Set cooperative level and the source window for the events.
|
|
|
|
*/
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SetCooperativeLevel(
|
2006-10-15 17:30:07 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface, HWND hwnd, DWORD dwflags)
|
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2006-10-15 17:30:07 +00:00
|
|
|
|
|
|
|
TRACE("(%p) %p,0x%08x\n", This, hwnd, dwflags);
|
|
|
|
TRACE(" cooperative level : ");
|
|
|
|
_dump_cooperativelevel_DI(dwflags);
|
|
|
|
|
|
|
|
if ((dwflags & (DISCL_EXCLUSIVE | DISCL_NONEXCLUSIVE)) == 0 ||
|
|
|
|
(dwflags & (DISCL_EXCLUSIVE | DISCL_NONEXCLUSIVE)) == (DISCL_EXCLUSIVE | DISCL_NONEXCLUSIVE) ||
|
|
|
|
(dwflags & (DISCL_FOREGROUND | DISCL_BACKGROUND)) == 0 ||
|
|
|
|
(dwflags & (DISCL_FOREGROUND | DISCL_BACKGROUND)) == (DISCL_FOREGROUND | DISCL_BACKGROUND))
|
|
|
|
return DIERR_INVALIDPARAM;
|
|
|
|
|
|
|
|
if (dwflags == (DISCL_NONEXCLUSIVE | DISCL_BACKGROUND))
|
|
|
|
hwnd = GetDesktopWindow();
|
|
|
|
|
|
|
|
if (!hwnd) return E_HANDLE;
|
|
|
|
|
|
|
|
/* For security reasons native does not allow exclusive background level
|
|
|
|
for mouse and keyboard only */
|
|
|
|
if (dwflags & DISCL_EXCLUSIVE && dwflags & DISCL_BACKGROUND &&
|
|
|
|
(IsEqualGUID(&This->guid, &GUID_SysMouse) ||
|
|
|
|
IsEqualGUID(&This->guid, &GUID_SysKeyboard)))
|
|
|
|
return DIERR_UNSUPPORTED;
|
|
|
|
|
|
|
|
/* Store the window which asks for the mouse */
|
2006-12-01 17:56:00 +00:00
|
|
|
EnterCriticalSection(&This->crit);
|
2006-10-15 17:30:07 +00:00
|
|
|
This->win = hwnd;
|
|
|
|
This->dwCoopLevel = dwflags;
|
2006-12-01 17:56:00 +00:00
|
|
|
LeaveCriticalSection(&This->crit);
|
2006-10-15 17:30:07 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2006-10-15 17:29:48 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* SetEventNotification : specifies event to be sent on state change
|
|
|
|
*/
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SetEventNotification(
|
2006-10-15 17:29:48 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface, HANDLE event)
|
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2006-10-15 17:29:48 +00:00
|
|
|
|
|
|
|
TRACE("(%p) %p\n", This, event);
|
|
|
|
|
2006-12-01 17:56:00 +00:00
|
|
|
EnterCriticalSection(&This->crit);
|
2006-10-15 17:29:48 +00:00
|
|
|
This->hEvent = event;
|
2006-12-01 17:56:00 +00:00
|
|
|
LeaveCriticalSection(&This->crit);
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
ULONG WINAPI IDirectInputDevice2AImpl_Release(LPDIRECTINPUTDEVICE8A iface)
|
2000-11-05 20:25:02 +00:00
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2004-09-17 18:10:41 +00:00
|
|
|
ULONG ref;
|
2006-12-04 17:54:05 +00:00
|
|
|
|
2004-09-17 18:10:41 +00:00
|
|
|
ref = InterlockedDecrement(&(This->ref));
|
2006-12-04 17:54:05 +00:00
|
|
|
if (ref) return ref;
|
|
|
|
|
2007-06-27 12:58:27 +00:00
|
|
|
IDirectInputDevice_Unacquire(iface);
|
|
|
|
/* Reset the FF state, free all effects, etc */
|
|
|
|
IDirectInputDevice8_SendForceFeedbackCommand(iface, DISFFC_RESET);
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
HeapFree(GetProcessHeap(), 0, This->data_queue);
|
2007-06-27 12:58:27 +00:00
|
|
|
|
|
|
|
/* Free data format */
|
|
|
|
HeapFree(GetProcessHeap(), 0, This->data_format.wine_df->rgodf);
|
|
|
|
HeapFree(GetProcessHeap(), 0, This->data_format.wine_df);
|
|
|
|
release_DataFormat(&This->data_format);
|
|
|
|
|
2007-07-07 05:36:09 +00:00
|
|
|
EnterCriticalSection( &This->dinput->crit );
|
|
|
|
list_remove( &This->entry );
|
|
|
|
LeaveCriticalSection( &This->dinput->crit );
|
|
|
|
|
2007-06-27 12:58:27 +00:00
|
|
|
IDirectInput_Release((LPDIRECTINPUTDEVICE8A)This->dinput);
|
|
|
|
This->crit.DebugInfo->Spare[0] = 0;
|
|
|
|
DeleteCriticalSection(&This->crit);
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
HeapFree(GetProcessHeap(), 0, This);
|
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_QueryInterface(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,REFIID riid,LPVOID *ppobj
|
2000-11-05 20:25:02 +00:00
|
|
|
)
|
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
TRACE("(this=%p,%s,%p)\n",This,debugstr_guid(riid),ppobj);
|
|
|
|
if (IsEqualGUID(&IID_IUnknown,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDeviceA,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice2A,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice7A,riid)) {
|
|
|
|
IDirectInputDevice7_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
2005-11-28 09:38:59 +00:00
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice8A,riid)) {
|
|
|
|
IDirectInputDevice8_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE("Unsupported interface !\n");
|
|
|
|
return E_FAIL;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_QueryInterface(
|
|
|
|
LPDIRECTINPUTDEVICE8W iface,REFIID riid,LPVOID *ppobj
|
|
|
|
)
|
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
TRACE("(this=%p,%s,%p)\n",This,debugstr_guid(riid),ppobj);
|
|
|
|
if (IsEqualGUID(&IID_IUnknown,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDeviceW,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice2W,riid)) {
|
|
|
|
IDirectInputDevice2_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice7W,riid)) {
|
|
|
|
IDirectInputDevice7_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
2005-11-28 09:38:59 +00:00
|
|
|
if (IsEqualGUID(&IID_IDirectInputDevice8W,riid)) {
|
|
|
|
IDirectInputDevice8_AddRef(iface);
|
|
|
|
*ppobj = This;
|
|
|
|
return DI_OK;
|
|
|
|
}
|
2004-06-02 00:36:54 +00:00
|
|
|
TRACE("Unsupported interface !\n");
|
|
|
|
return E_FAIL;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
ULONG WINAPI IDirectInputDevice2AImpl_AddRef(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface)
|
2000-11-05 20:25:02 +00:00
|
|
|
{
|
2004-09-09 20:17:07 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2004-09-17 18:10:41 +00:00
|
|
|
return InterlockedIncrement(&(This->ref));
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2007-01-04 18:59:23 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_EnumObjects(LPDIRECTINPUTDEVICE8A iface,
|
|
|
|
LPDIENUMDEVICEOBJECTSCALLBACKA lpCallback, LPVOID lpvRef, DWORD dwFlags)
|
2000-11-05 20:25:02 +00:00
|
|
|
{
|
2006-12-27 23:32:19 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
DIDEVICEOBJECTINSTANCEA ddoi;
|
2007-01-04 18:59:23 +00:00
|
|
|
int i;
|
2006-12-27 23:32:19 +00:00
|
|
|
|
|
|
|
TRACE("(%p) %p,%p flags:%08x)\n", iface, lpCallback, lpvRef, dwFlags);
|
|
|
|
TRACE(" - flags = ");
|
|
|
|
_dump_EnumObjects_flags(dwFlags);
|
|
|
|
TRACE("\n");
|
|
|
|
|
|
|
|
/* Only the fields till dwFFMaxForce are relevant */
|
|
|
|
memset(&ddoi, 0, sizeof(ddoi));
|
|
|
|
ddoi.dwSize = FIELD_OFFSET(DIDEVICEOBJECTINSTANCEA, dwFFMaxForce);
|
|
|
|
|
|
|
|
for (i = 0; i < This->data_format.wine_df->dwNumObjs; i++)
|
|
|
|
{
|
2007-01-04 18:59:23 +00:00
|
|
|
LPDIOBJECTDATAFORMAT odf = dataformat_to_odf(This->data_format.wine_df, i);
|
2006-12-27 23:32:19 +00:00
|
|
|
|
2007-01-04 18:59:23 +00:00
|
|
|
if (dwFlags != DIDFT_ALL && !(dwFlags & DIEFT_GETTYPE(odf->dwType))) continue;
|
|
|
|
if (IDirectInputDevice_GetObjectInfo(iface, &ddoi, odf->dwType, DIPH_BYID) != DI_OK)
|
|
|
|
continue;
|
2006-12-27 23:32:19 +00:00
|
|
|
|
|
|
|
if (lpCallback(&ddoi, lpvRef) != DIENUM_CONTINUE) break;
|
2004-06-02 00:36:54 +00:00
|
|
|
}
|
2006-12-27 23:32:19 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2007-01-04 18:59:23 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_EnumObjects(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIENUMDEVICEOBJECTSCALLBACKW lpCallback, LPVOID lpvRef, DWORD dwFlags)
|
2003-06-16 20:22:13 +00:00
|
|
|
{
|
2007-01-04 18:59:23 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
DIDEVICEOBJECTINSTANCEW ddoi;
|
|
|
|
int i;
|
2006-12-27 23:32:19 +00:00
|
|
|
|
2007-01-04 18:59:23 +00:00
|
|
|
TRACE("(%p) %p,%p flags:%08x)\n", iface, lpCallback, lpvRef, dwFlags);
|
|
|
|
TRACE(" - flags = ");
|
|
|
|
_dump_EnumObjects_flags(dwFlags);
|
|
|
|
TRACE("\n");
|
2006-12-27 23:32:19 +00:00
|
|
|
|
2007-01-04 18:59:23 +00:00
|
|
|
/* Only the fields till dwFFMaxForce are relevant */
|
|
|
|
memset(&ddoi, 0, sizeof(ddoi));
|
|
|
|
ddoi.dwSize = FIELD_OFFSET(DIDEVICEOBJECTINSTANCEW, dwFFMaxForce);
|
|
|
|
|
|
|
|
for (i = 0; i < This->data_format.wine_df->dwNumObjs; i++)
|
|
|
|
{
|
|
|
|
LPDIOBJECTDATAFORMAT odf = dataformat_to_odf(This->data_format.wine_df, i);
|
|
|
|
|
|
|
|
if (dwFlags != DIDFT_ALL && !(dwFlags & DIEFT_GETTYPE(odf->dwType))) continue;
|
|
|
|
if (IDirectInputDevice_GetObjectInfo(iface, &ddoi, odf->dwType, DIPH_BYID) != DI_OK)
|
|
|
|
continue;
|
|
|
|
|
|
|
|
if (lpCallback(&ddoi, lpvRef) != DIENUM_CONTINUE) break;
|
|
|
|
}
|
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* GetProperty
|
|
|
|
*/
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetProperty(
|
2006-12-04 17:54:05 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface, REFGUID rguid, LPDIPROPHEADER pdiph)
|
2000-11-05 20:25:02 +00:00
|
|
|
{
|
2006-12-04 17:54:05 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
|
|
|
|
TRACE("(%p) %s,%p\n", iface, debugstr_guid(rguid), pdiph);
|
|
|
|
_dump_DIPROPHEADER(pdiph);
|
|
|
|
|
|
|
|
if (HIWORD(rguid)) return DI_OK;
|
|
|
|
|
|
|
|
switch (LOWORD(rguid))
|
|
|
|
{
|
|
|
|
case (DWORD) DIPROP_BUFFERSIZE:
|
|
|
|
{
|
|
|
|
LPDIPROPDWORD pd = (LPDIPROPDWORD)pdiph;
|
|
|
|
|
|
|
|
if (pdiph->dwSize != sizeof(DIPROPDWORD)) return DIERR_INVALIDPARAM;
|
|
|
|
|
|
|
|
pd->dwData = This->queue_len;
|
|
|
|
TRACE("buffersize = %d\n", pd->dwData);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
default:
|
|
|
|
WARN("Unknown property %s\n", debugstr_guid(rguid));
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
return DI_OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* SetProperty
|
|
|
|
*/
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SetProperty(
|
|
|
|
LPDIRECTINPUTDEVICE8A iface, REFGUID rguid, LPCDIPROPHEADER pdiph)
|
|
|
|
{
|
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
|
|
|
|
TRACE("(%p) %s,%p\n", iface, debugstr_guid(rguid), pdiph);
|
|
|
|
_dump_DIPROPHEADER(pdiph);
|
|
|
|
|
|
|
|
if (HIWORD(rguid)) return DI_OK;
|
|
|
|
|
|
|
|
switch (LOWORD(rguid))
|
|
|
|
{
|
2006-12-18 06:22:11 +00:00
|
|
|
case (DWORD) DIPROP_AXISMODE:
|
|
|
|
{
|
|
|
|
LPCDIPROPDWORD pd = (LPCDIPROPDWORD)pdiph;
|
|
|
|
|
|
|
|
if (pdiph->dwSize != sizeof(DIPROPDWORD)) return DIERR_INVALIDPARAM;
|
|
|
|
if (pdiph->dwHow == DIPH_DEVICE && pdiph->dwObj) return DIERR_INVALIDPARAM;
|
|
|
|
if (This->acquired) return DIERR_ACQUIRED;
|
|
|
|
if (pdiph->dwHow != DIPH_DEVICE) return DIERR_UNSUPPORTED;
|
2006-12-27 23:32:19 +00:00
|
|
|
if (!This->data_format.user_df) return DI_OK;
|
2006-12-18 06:22:11 +00:00
|
|
|
|
|
|
|
TRACE("Axis mode: %s\n", pd->dwData == DIPROPAXISMODE_ABS ? "absolute" :
|
|
|
|
"relative");
|
|
|
|
|
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
This->data_format.user_df->dwFlags &= ~DIDFT_AXIS;
|
|
|
|
This->data_format.user_df->dwFlags |= pd->dwData == DIPROPAXISMODE_ABS ?
|
|
|
|
DIDF_ABSAXIS : DIDF_RELAXIS;
|
|
|
|
LeaveCriticalSection(&This->crit);
|
|
|
|
break;
|
|
|
|
}
|
2006-12-04 17:54:05 +00:00
|
|
|
case (DWORD) DIPROP_BUFFERSIZE:
|
|
|
|
{
|
|
|
|
LPCDIPROPDWORD pd = (LPCDIPROPDWORD)pdiph;
|
|
|
|
|
|
|
|
if (pdiph->dwSize != sizeof(DIPROPDWORD)) return DIERR_INVALIDPARAM;
|
|
|
|
if (This->acquired) return DIERR_ACQUIRED;
|
|
|
|
|
|
|
|
TRACE("buffersize = %d\n", pd->dwData);
|
|
|
|
|
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
HeapFree(GetProcessHeap(), 0, This->data_queue);
|
|
|
|
|
|
|
|
This->data_queue = !pd->dwData ? NULL : HeapAlloc(GetProcessHeap(), 0,
|
|
|
|
pd->dwData * sizeof(DIDEVICEOBJECTDATA));
|
|
|
|
This->queue_head = This->queue_tail = This->overflow = 0;
|
|
|
|
This->queue_len = pd->dwData;
|
|
|
|
|
|
|
|
LeaveCriticalSection(&This->crit);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
default:
|
|
|
|
WARN("Unknown property %s\n", debugstr_guid(rguid));
|
|
|
|
return DIERR_UNSUPPORTED;
|
|
|
|
}
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetObjectInfo(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIDEVICEOBJECTINSTANCEA pdidoi,
|
|
|
|
DWORD dwObj,
|
|
|
|
DWORD dwHow)
|
|
|
|
{
|
2007-01-04 06:04:24 +00:00
|
|
|
DIDEVICEOBJECTINSTANCEW didoiW;
|
|
|
|
HRESULT res;
|
|
|
|
|
|
|
|
if (!pdidoi ||
|
|
|
|
(pdidoi->dwSize != sizeof(DIDEVICEOBJECTINSTANCEA) &&
|
|
|
|
pdidoi->dwSize != sizeof(DIDEVICEOBJECTINSTANCE_DX3A)))
|
|
|
|
return DIERR_INVALIDPARAM;
|
|
|
|
|
|
|
|
didoiW.dwSize = sizeof(didoiW);
|
|
|
|
res = IDirectInputDevice2WImpl_GetObjectInfo((LPDIRECTINPUTDEVICE8W)iface, &didoiW, dwObj, dwHow);
|
|
|
|
if (res == DI_OK)
|
|
|
|
{
|
|
|
|
DWORD dwSize = pdidoi->dwSize;
|
|
|
|
|
|
|
|
memset(pdidoi, 0, pdidoi->dwSize);
|
|
|
|
pdidoi->dwSize = dwSize;
|
|
|
|
pdidoi->guidType = didoiW.guidType;
|
|
|
|
pdidoi->dwOfs = didoiW.dwOfs;
|
|
|
|
pdidoi->dwType = didoiW.dwType;
|
|
|
|
pdidoi->dwFlags = didoiW.dwFlags;
|
|
|
|
}
|
|
|
|
|
|
|
|
return res;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_GetObjectInfo(
|
|
|
|
LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIDEVICEOBJECTINSTANCEW pdidoi,
|
|
|
|
DWORD dwObj,
|
|
|
|
DWORD dwHow)
|
|
|
|
{
|
2007-01-04 06:04:24 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
2007-02-01 15:08:21 +00:00
|
|
|
DWORD dwSize;
|
2007-01-04 06:04:24 +00:00
|
|
|
LPDIOBJECTDATAFORMAT odf;
|
|
|
|
int idx = -1;
|
|
|
|
|
|
|
|
TRACE("(%p) %d(0x%08x) -> %p\n", This, dwHow, dwObj, pdidoi);
|
|
|
|
|
|
|
|
if (!pdidoi ||
|
|
|
|
(pdidoi->dwSize != sizeof(DIDEVICEOBJECTINSTANCEW) &&
|
|
|
|
pdidoi->dwSize != sizeof(DIDEVICEOBJECTINSTANCE_DX3W)))
|
|
|
|
return DIERR_INVALIDPARAM;
|
|
|
|
|
|
|
|
switch (dwHow)
|
|
|
|
{
|
|
|
|
case DIPH_BYOFFSET:
|
|
|
|
if (!This->data_format.offsets) break;
|
|
|
|
for (idx = This->data_format.wine_df->dwNumObjs - 1; idx >= 0; idx--)
|
|
|
|
if (This->data_format.offsets[idx] == dwObj) break;
|
|
|
|
break;
|
|
|
|
case DIPH_BYID:
|
|
|
|
dwObj &= 0x00ffffff;
|
|
|
|
for (idx = This->data_format.wine_df->dwNumObjs - 1; idx >= 0; idx--)
|
|
|
|
if ((dataformat_to_odf(This->data_format.wine_df, idx)->dwType & 0x00ffffff) == dwObj)
|
|
|
|
break;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case DIPH_BYUSAGE:
|
|
|
|
FIXME("dwHow = DIPH_BYUSAGE not implemented\n");
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
WARN("invalid parameter: dwHow = %08x\n", dwHow);
|
|
|
|
return DIERR_INVALIDPARAM;
|
|
|
|
}
|
|
|
|
if (idx < 0) return DIERR_OBJECTNOTFOUND;
|
|
|
|
|
|
|
|
odf = dataformat_to_odf(This->data_format.wine_df, idx);
|
2007-02-01 15:08:21 +00:00
|
|
|
dwSize = pdidoi->dwSize; /* save due to memset below */
|
2007-01-04 06:04:24 +00:00
|
|
|
memset(pdidoi, 0, pdidoi->dwSize);
|
|
|
|
pdidoi->dwSize = dwSize;
|
2007-01-06 00:15:09 +00:00
|
|
|
if (odf->pguid) pdidoi->guidType = *odf->pguid;
|
2007-01-04 06:04:24 +00:00
|
|
|
pdidoi->dwOfs = This->data_format.offsets ? This->data_format.offsets[idx] : odf->dwOfs;
|
|
|
|
pdidoi->dwType = odf->dwType;
|
|
|
|
pdidoi->dwFlags = odf->dwFlags;
|
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2006-12-04 17:54:05 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetDeviceData(
|
|
|
|
LPDIRECTINPUTDEVICE8A iface, DWORD dodsize, LPDIDEVICEOBJECTDATA dod,
|
|
|
|
LPDWORD entries, DWORD flags)
|
|
|
|
{
|
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
HRESULT ret = DI_OK;
|
|
|
|
int len;
|
|
|
|
|
|
|
|
TRACE("(%p) %p -> %p(%d) x%d, 0x%08x\n",
|
|
|
|
This, dod, entries, entries ? *entries : 0, dodsize, flags);
|
|
|
|
|
|
|
|
if (!This->acquired)
|
|
|
|
return DIERR_NOTACQUIRED;
|
|
|
|
if (!This->queue_len)
|
|
|
|
return DIERR_NOTBUFFERED;
|
|
|
|
if (dodsize < sizeof(DIDEVICEOBJECTDATA_DX3))
|
|
|
|
return DIERR_INVALIDPARAM;
|
|
|
|
|
|
|
|
IDirectInputDevice2_Poll(iface);
|
|
|
|
EnterCriticalSection(&This->crit);
|
|
|
|
|
|
|
|
len = This->queue_head - This->queue_tail;
|
|
|
|
if (len < 0) len += This->queue_len;
|
|
|
|
|
|
|
|
if ((*entries != INFINITE) && (len > *entries)) len = *entries;
|
|
|
|
|
|
|
|
if (dod)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
for (i = 0; i < len; i++)
|
|
|
|
{
|
|
|
|
int n = (This->queue_tail + i) % This->queue_len;
|
|
|
|
memcpy((char *)dod + dodsize * i, This->data_queue + n, dodsize);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
*entries = len;
|
|
|
|
|
|
|
|
if (This->overflow)
|
|
|
|
ret = DI_BUFFEROVERFLOW;
|
|
|
|
|
|
|
|
if (!(flags & DIGDD_PEEK))
|
|
|
|
{
|
|
|
|
/* Advance reading position */
|
|
|
|
This->queue_tail = (This->queue_tail + len) % This->queue_len;
|
|
|
|
This->overflow = FALSE;
|
|
|
|
}
|
|
|
|
|
|
|
|
LeaveCriticalSection(&This->crit);
|
|
|
|
|
|
|
|
TRACE("Returning %d events queued\n", *entries);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetDeviceInfo(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIDEVICEINSTANCEA pdidi)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p): stub!\n",
|
|
|
|
iface, pdidi);
|
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2004-06-02 00:36:54 +00:00
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_GetDeviceInfo(
|
|
|
|
LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIDEVICEINSTANCEW pdidi)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p): stub!\n",
|
|
|
|
iface, pdidi);
|
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_RunControlPanel(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
HWND hwndOwner,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,%p,0x%08x): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, hwndOwner, dwFlags);
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2004-06-02 00:36:54 +00:00
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_Initialize(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
HINSTANCE hinst,
|
|
|
|
DWORD dwVersion,
|
|
|
|
REFGUID rguid)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,%p,%d,%s): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, hinst, dwVersion, debugstr_guid(rguid));
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2002-05-31 23:06:46 +00:00
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* IDirectInputDevice2A
|
|
|
|
*/
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_CreateEffect(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
REFGUID rguid,
|
|
|
|
LPCDIEFFECT lpeff,
|
|
|
|
LPDIRECTINPUTEFFECT *ppdef,
|
|
|
|
LPUNKNOWN pUnkOuter)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%s,%p,%p,%p): stub!\n",
|
|
|
|
iface, debugstr_guid(rguid), lpeff, ppdef, pUnkOuter);
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_EnumEffects(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIENUMEFFECTSCALLBACKA lpCallback,
|
|
|
|
LPVOID lpvRef,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,%p,%p,0x%08x): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, lpCallback, lpvRef, dwFlags);
|
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_EnumEffects(
|
|
|
|
LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIENUMEFFECTSCALLBACKW lpCallback,
|
|
|
|
LPVOID lpvRef,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,%p,%p,0x%08x): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, lpCallback, lpvRef, dwFlags);
|
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetEffectInfo(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIEFFECTINFOA lpdei,
|
|
|
|
REFGUID rguid)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p,%s): stub!\n",
|
|
|
|
iface, lpdei, debugstr_guid(rguid));
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2WImpl_GetEffectInfo(
|
|
|
|
LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIEFFECTINFOW lpdei,
|
|
|
|
REFGUID rguid)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p,%s): stub!\n",
|
|
|
|
iface, lpdei, debugstr_guid(rguid));
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2000-11-05 20:25:02 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_GetForceFeedbackState(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDWORD pdwOut)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p): stub!\n",
|
|
|
|
iface, pdwOut);
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SendForceFeedbackCommand(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2007-06-27 12:58:27 +00:00
|
|
|
TRACE("(%p) 0x%08x:\n", iface, dwFlags);
|
|
|
|
return DI_NOEFFECT;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_EnumCreatedEffectObjects(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIENUMCREATEDEFFECTOBJECTSCALLBACK lpCallback,
|
|
|
|
LPVOID lpvRef,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,%p,%p,0x%08x): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, lpCallback, lpvRef, dwFlags);
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_Escape(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDIEFFESCAPE lpDIEEsc)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(this=%p,%p): stub!\n",
|
|
|
|
iface, lpDIEEsc);
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_Poll(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface)
|
2000-11-05 20:25:02 +00:00
|
|
|
{
|
2006-12-10 06:56:58 +00:00
|
|
|
IDirectInputDevice2AImpl *This = (IDirectInputDevice2AImpl *)iface;
|
|
|
|
|
|
|
|
if (!This->acquired) return DIERR_NOTACQUIRED;
|
2004-06-02 00:36:54 +00:00
|
|
|
/* Because wine devices do not need to be polled, just return DI_NOEFFECT */
|
|
|
|
return DI_NOEFFECT;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice2AImpl_SendDeviceData(
|
2002-06-14 00:39:44 +00:00
|
|
|
LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
DWORD cbObjectData,
|
2002-06-14 00:39:44 +00:00
|
|
|
LPCDIDEVICEOBJECTDATA rgdod,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPDWORD pdwInOut,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(this=%p,0x%08x,%p,%p,0x%08x): stub!\n",
|
2004-06-02 00:36:54 +00:00
|
|
|
iface, cbObjectData, rgdod, pdwInOut, dwFlags);
|
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice7AImpl_EnumEffectsInFile(LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPCSTR lpszFileName,
|
|
|
|
LPDIENUMEFFECTSINFILECALLBACK pec,
|
|
|
|
LPVOID pvRef,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%s,%p,%p,%08x): stub !\n", iface, lpszFileName, pec, pvRef, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice7WImpl_EnumEffectsInFile(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPCWSTR lpszFileName,
|
|
|
|
LPDIENUMEFFECTSINFILECALLBACK pec,
|
|
|
|
LPVOID pvRef,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%s,%p,%p,%08x): stub !\n", iface, debugstr_w(lpszFileName), pec, pvRef, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice7AImpl_WriteEffectToFile(LPDIRECTINPUTDEVICE8A iface,
|
2000-11-05 20:25:02 +00:00
|
|
|
LPCSTR lpszFileName,
|
|
|
|
DWORD dwEntries,
|
|
|
|
LPDIFILEEFFECT rgDiFileEft,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%s,%08x,%p,%08x): stub !\n", iface, lpszFileName, dwEntries, rgDiFileEft, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2000-11-05 20:25:02 +00:00
|
|
|
}
|
2002-06-14 00:39:44 +00:00
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice7WImpl_WriteEffectToFile(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPCWSTR lpszFileName,
|
|
|
|
DWORD dwEntries,
|
|
|
|
LPDIFILEEFFECT rgDiFileEft,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%s,%08x,%p,%08x): stub !\n", iface, debugstr_w(lpszFileName), dwEntries, rgDiFileEft, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice8AImpl_BuildActionMap(LPDIRECTINPUTDEVICE8A iface,
|
|
|
|
LPDIACTIONFORMATA lpdiaf,
|
|
|
|
LPCSTR lpszUserName,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%p,%s,%08x): stub !\n", iface, lpdiaf, lpszUserName, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2002-06-14 00:39:44 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice8WImpl_BuildActionMap(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIACTIONFORMATW lpdiaf,
|
|
|
|
LPCWSTR lpszUserName,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%p,%s,%08x): stub !\n", iface, lpdiaf, debugstr_w(lpszUserName), dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice8AImpl_SetActionMap(LPDIRECTINPUTDEVICE8A iface,
|
|
|
|
LPDIACTIONFORMATA lpdiaf,
|
|
|
|
LPCSTR lpszUserName,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%p,%s,%08x): stub !\n", iface, lpdiaf, lpszUserName, dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2002-06-14 00:39:44 +00:00
|
|
|
}
|
|
|
|
|
2003-06-16 20:22:13 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice8WImpl_SetActionMap(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIACTIONFORMATW lpdiaf,
|
|
|
|
LPCWSTR lpszUserName,
|
|
|
|
DWORD dwFlags)
|
|
|
|
{
|
2006-10-07 23:55:40 +00:00
|
|
|
FIXME("(%p)->(%p,%s,%08x): stub !\n", iface, lpdiaf, debugstr_w(lpszUserName), dwFlags);
|
2004-06-02 00:36:54 +00:00
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|
|
|
|
|
2002-06-14 00:39:44 +00:00
|
|
|
HRESULT WINAPI IDirectInputDevice8AImpl_GetImageInfo(LPDIRECTINPUTDEVICE8A iface,
|
|
|
|
LPDIDEVICEIMAGEINFOHEADERA lpdiDevImageInfoHeader)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(%p)->(%p): stub !\n", iface, lpdiDevImageInfoHeader);
|
|
|
|
|
|
|
|
return DI_OK;
|
2002-06-14 00:39:44 +00:00
|
|
|
}
|
2003-06-16 20:22:13 +00:00
|
|
|
|
|
|
|
HRESULT WINAPI IDirectInputDevice8WImpl_GetImageInfo(LPDIRECTINPUTDEVICE8W iface,
|
|
|
|
LPDIDEVICEIMAGEINFOHEADERW lpdiDevImageInfoHeader)
|
|
|
|
{
|
2004-06-02 00:36:54 +00:00
|
|
|
FIXME("(%p)->(%p): stub !\n", iface, lpdiDevImageInfoHeader);
|
|
|
|
|
|
|
|
return DI_OK;
|
2003-06-16 20:22:13 +00:00
|
|
|
}
|