renun/ViGEmBus
1
0
Fork 0
mirror of https://github.com/nefarius/ViGEmBus.git synced 2025-08-10 00:52:17 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Renamed variable

Browse Source
This commit is contained in:
Benjamin Höglinger-Stelzer
2022-08-06 12:16:33 +02:00
parent d0052f95a5
commit e18a4cb721
4 changed files with 389 additions and 383 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
ViGEmBus.sln.DotSettings
View File

@@ -1,4 +1,11 @@
<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
<s:Boolean x:Key="/Default/UserDictionary/Words/=DPAD/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=gamepad/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=Lightbar/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=PEMULATION/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=PPDO/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=PVIGEM/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=TOUCHPAD/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=VIGEM/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=Xbox/@EntryIndexedValue">True</s:Boolean>
<s:Boolean x:Key="/Default/UserDictionary/Words/=Xusb/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

740
sdk/include/ViGEm/Client.h
View File

@@ -41,413 +41,413 @@ extern "C" {
#else
#define VIGEM_API
#endif
/** Values that represent ViGEm errors */
typedef enum _VIGEM_ERRORS
{
VIGEM_ERROR_NONE = 0x20000000,
VIGEM_ERROR_BUS_NOT_FOUND = 0xE0000001,
VIGEM_ERROR_NO_FREE_SLOT = 0xE0000002,
VIGEM_ERROR_INVALID_TARGET = 0xE0000003,
VIGEM_ERROR_REMOVAL_FAILED = 0xE0000004,
VIGEM_ERROR_ALREADY_CONNECTED = 0xE0000005,
VIGEM_ERROR_TARGET_UNINITIALIZED = 0xE0000006,
VIGEM_ERROR_TARGET_NOT_PLUGGED_IN = 0xE0000007,
VIGEM_ERROR_BUS_VERSION_MISMATCH = 0xE0000008,
VIGEM_ERROR_BUS_ACCESS_FAILED = 0xE0000009,
VIGEM_ERROR_CALLBACK_ALREADY_REGISTERED = 0xE0000010,
VIGEM_ERROR_CALLBACK_NOT_FOUND = 0xE0000011,
VIGEM_ERROR_BUS_ALREADY_CONNECTED = 0xE0000012,
VIGEM_ERROR_BUS_INVALID_HANDLE = 0xE0000013,
VIGEM_ERROR_XUSB_USERINDEX_OUT_OF_RANGE = 0xE0000014,
/** Values that represent ViGEm errors */
typedef enum _VIGEM_ERRORS
{
VIGEM_ERROR_NONE = 0x20000000,
VIGEM_ERROR_BUS_NOT_FOUND = 0xE0000001,
VIGEM_ERROR_NO_FREE_SLOT = 0xE0000002,
VIGEM_ERROR_INVALID_TARGET = 0xE0000003,
VIGEM_ERROR_REMOVAL_FAILED = 0xE0000004,
VIGEM_ERROR_ALREADY_CONNECTED = 0xE0000005,
VIGEM_ERROR_TARGET_UNINITIALIZED = 0xE0000006,
VIGEM_ERROR_TARGET_NOT_PLUGGED_IN = 0xE0000007,
VIGEM_ERROR_BUS_VERSION_MISMATCH = 0xE0000008,
VIGEM_ERROR_BUS_ACCESS_FAILED = 0xE0000009,
VIGEM_ERROR_CALLBACK_ALREADY_REGISTERED = 0xE0000010,
VIGEM_ERROR_CALLBACK_NOT_FOUND = 0xE0000011,
VIGEM_ERROR_BUS_ALREADY_CONNECTED = 0xE0000012,
VIGEM_ERROR_BUS_INVALID_HANDLE = 0xE0000013,
VIGEM_ERROR_XUSB_USERINDEX_OUT_OF_RANGE = 0xE0000014,
VIGEM_ERROR_INVALID_PARAMETER = 0xE0000015,
VIGEM_ERROR_NOT_SUPPORTED = 0xE0000016
VIGEM_ERROR_NOT_SUPPORTED = 0xE0000016
} VIGEM_ERROR;
} VIGEM_ERROR;
/**
* A macro that defines if the API succeeded
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 01.09.2020
*
* @param _val_ The error value.
*/
/**
* A macro that defines if the API succeeded
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 01.09.2020
*
* @param _val_ The error value.
*/
#define VIGEM_SUCCESS(_val_) (_val_ == VIGEM_ERROR_NONE)
/** Defines an alias representing a driver connection object */
typedef struct _VIGEM_CLIENT_T *PVIGEM_CLIENT;
/** Defines an alias representing a driver connection object */
typedef struct _VIGEM_CLIENT_T* PVIGEM_CLIENT;
/** Defines an alias representing a target device object */
typedef struct _VIGEM_TARGET_T *PVIGEM_TARGET;
/** Defines an alias representing a target device object */
typedef struct _VIGEM_TARGET_T* PVIGEM_TARGET;
typedef
_Function_class_(EVT_VIGEM_TARGET_ADD_RESULT)
VOID CALLBACK
EVT_VIGEM_TARGET_ADD_RESULT(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
VIGEM_ERROR Result
);
typedef
_Function_class_(EVT_VIGEM_TARGET_ADD_RESULT)
VOID CALLBACK
EVT_VIGEM_TARGET_ADD_RESULT(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
VIGEM_ERROR Result
);
typedef EVT_VIGEM_TARGET_ADD_RESULT *PFN_VIGEM_TARGET_ADD_RESULT;
typedef EVT_VIGEM_TARGET_ADD_RESULT* PFN_VIGEM_TARGET_ADD_RESULT;
typedef
_Function_class_(EVT_VIGEM_X360_NOTIFICATION)
VOID CALLBACK
EVT_VIGEM_X360_NOTIFICATION(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
UCHAR LargeMotor,
UCHAR SmallMotor,
UCHAR LedNumber,
LPVOID UserData
);
typedef
_Function_class_(EVT_VIGEM_X360_NOTIFICATION)
VOID CALLBACK
EVT_VIGEM_X360_NOTIFICATION(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
UCHAR LargeMotor,
UCHAR SmallMotor,
UCHAR LedNumber,
LPVOID UserData
);
typedef EVT_VIGEM_X360_NOTIFICATION *PFN_VIGEM_X360_NOTIFICATION;
typedef EVT_VIGEM_X360_NOTIFICATION* PFN_VIGEM_X360_NOTIFICATION;
typedef
_Function_class_(EVT_VIGEM_DS4_NOTIFICATION)
VOID CALLBACK
EVT_VIGEM_DS4_NOTIFICATION(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
UCHAR LargeMotor,
UCHAR SmallMotor,
DS4_LIGHTBAR_COLOR LightbarColor,
LPVOID UserData
);
typedef
_Function_class_(EVT_VIGEM_DS4_NOTIFICATION)
VOID CALLBACK
EVT_VIGEM_DS4_NOTIFICATION(
PVIGEM_CLIENT Client,
PVIGEM_TARGET Target,
UCHAR LargeMotor,
UCHAR SmallMotor,
DS4_LIGHTBAR_COLOR LightbarColor,
LPVOID UserData
);
typedef EVT_VIGEM_DS4_NOTIFICATION *PFN_VIGEM_DS4_NOTIFICATION;
typedef EVT_VIGEM_DS4_NOTIFICATION* PFN_VIGEM_DS4_NOTIFICATION;
/**
* Allocates an object representing a driver connection
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_CLIENT object.
*/
VIGEM_API PVIGEM_CLIENT vigem_alloc(void);
/**
* Allocates an object representing a driver connection
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_CLIENT object.
*/
VIGEM_API PVIGEM_CLIENT vigem_alloc(void);
/**
* Frees up memory used by the driver connection object
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*/
VIGEM_API void vigem_free(PVIGEM_CLIENT vigem);
/**
* Frees up memory used by the driver connection object
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*/
VIGEM_API void vigem_free(PVIGEM_CLIENT vigem);
/**
* Initializes the driver object and establishes a connection to the emulation bus
* driver. Returns an error if no compatible bus device has been found.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_connect(PVIGEM_CLIENT vigem);
/**
* Initializes the driver object and establishes a connection to the emulation bus
* driver. Returns an error if no compatible bus device has been found.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_connect(PVIGEM_CLIENT vigem);
/**
* Disconnects from the bus device and resets the driver object state. The driver object
* may be reused again after calling this function. When called, all targets which may
* still be connected will be destroyed automatically. Be aware, that allocated target
* objects won't be automatically freed, this has to be taken care of by the caller.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*/
VIGEM_API void vigem_disconnect(PVIGEM_CLIENT vigem);
/**
* Disconnects from the bus device and resets the driver object state. The driver object
* may be reused again after calling this function. When called, all targets which may
* still be connected will be destroyed automatically. Be aware, that allocated target
* objects won't be automatically freed, this has to be taken care of by the caller.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The PVIGEM_CLIENT object.
*/
VIGEM_API void vigem_disconnect(PVIGEM_CLIENT vigem);
/**
* Allocates an object representing an Xbox 360 Controller device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_TARGET representing an Xbox 360 Controller device.
*/
VIGEM_API PVIGEM_TARGET vigem_target_x360_alloc(void);
/**
* Allocates an object representing an Xbox 360 Controller device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_TARGET representing an Xbox 360 Controller device.
*/
VIGEM_API PVIGEM_TARGET vigem_target_x360_alloc(void);
/**
* Allocates an object representing a DualShock 4 Controller device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_TARGET representing a DualShock 4 Controller device.
*/
VIGEM_API PVIGEM_TARGET vigem_target_ds4_alloc(void);
/**
* Allocates an object representing a DualShock 4 Controller device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @returns A PVIGEM_TARGET representing a DualShock 4 Controller device.
*/
VIGEM_API PVIGEM_TARGET vigem_target_ds4_alloc(void);
/**
* Frees up memory used by the target device object. This does not automatically remove
* the associated device from the bus, if present. If the target device doesn't get
* removed before this call, the device becomes orphaned until the owning process is
* terminated.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_free(PVIGEM_TARGET target);
/**
* Frees up memory used by the target device object. This does not automatically remove
* the associated device from the bus, if present. If the target device doesn't get
* removed before this call, the device becomes orphaned until the owning process is
* terminated.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_free(PVIGEM_TARGET target);
/**
* Adds a provided target device to the bus driver, which is equal to a device plug-in
* event of a physical hardware device. This function blocks until the target device is
* in full operational mode.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_add(PVIGEM_CLIENT vigem, PVIGEM_TARGET target);
/**
* Adds a provided target device to the bus driver, which is equal to a device plug-in
* event of a physical hardware device. This function blocks until the target device is
* in full operational mode.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_add(PVIGEM_CLIENT vigem, PVIGEM_TARGET target);
/**
* Adds a provided target device to the bus driver, which is equal to a device plug-in
* event of a physical hardware device. This function immediately returns. An optional
* callback may be registered which gets called on error or if the target device has
* become fully operational.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param result An optional function getting called when the target device becomes available.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_add_async(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_TARGET_ADD_RESULT result);
/**
* Adds a provided target device to the bus driver, which is equal to a device plug-in
* event of a physical hardware device. This function immediately returns. An optional
* callback may be registered which gets called on error or if the target device has
* become fully operational.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param result An optional function getting called when the target device becomes available.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_add_async(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_TARGET_ADD_RESULT result);
/**
* Removes a provided target device from the bus driver, which is equal to a device
* unplug event of a physical hardware device. The target device object may be reused
* after this function is called. If this function is never called on target device
* objects, they will be removed from the bus when the owning process terminates.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_remove(PVIGEM_CLIENT vigem, PVIGEM_TARGET target);
/**
* Removes a provided target device from the bus driver, which is equal to a device
* unplug event of a physical hardware device. The target device object may be reused
* after this function is called. If this function is never called on target device
* objects, they will be removed from the bus when the owning process terminates.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_remove(PVIGEM_CLIENT vigem, PVIGEM_TARGET target);
/**
* Registers a function which gets called, when LED index or vibration state changes
* occur on the provided target device. This function fails if the provided
* target device isn't fully operational or in an erroneous state.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param notification The notification callback.
* @param userData The user data passed to the notification callback.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_register_notification(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_X360_NOTIFICATION notification, LPVOID userData);
/**
* Registers a function which gets called, when LED index or vibration state changes
* occur on the provided target device. This function fails if the provided
* target device isn't fully operational or in an erroneous state.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param notification The notification callback.
* @param userData The user data passed to the notification callback.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_register_notification(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_X360_NOTIFICATION notification, LPVOID userData);
/**
* Registers a function which gets called, when LightBar or vibration state changes
* occur on the provided target device. This function fails if the provided
* target device isn't fully operational or in an erroneous state.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param notification The notification callback.
* @param userData The user data passed to the notification callback.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_register_notification(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_DS4_NOTIFICATION notification, LPVOID userData);
/**
* Registers a function which gets called, when LightBar or vibration state changes
* occur on the provided target device. This function fails if the provided
* target device isn't fully operational or in an erroneous state.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param notification The notification callback.
* @param userData The user data passed to the notification callback.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_register_notification(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PFN_VIGEM_DS4_NOTIFICATION notification, LPVOID userData);
/**
* Removes a previously registered callback function from the provided target object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_x360_unregister_notification(PVIGEM_TARGET target);
/**
* Removes a previously registered callback function from the provided target object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_x360_unregister_notification(PVIGEM_TARGET target);
/**
* Removes a previously registered callback function from the provided target object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_ds4_unregister_notification(PVIGEM_TARGET target);
/**
* Removes a previously registered callback function from the provided target object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*/
VIGEM_API void vigem_target_ds4_unregister_notification(PVIGEM_TARGET target);
/**
* Overrides the default Vendor ID value with the provided one.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
* @param vid The Vendor ID to set.
*/
VIGEM_API void vigem_target_set_vid(PVIGEM_TARGET target, USHORT vid);
/**
* Overrides the default Vendor ID value with the provided one.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
* @param vid The Vendor ID to set.
*/
VIGEM_API void vigem_target_set_vid(PVIGEM_TARGET target, USHORT vid);
/**
* Overrides the default Product ID value with the provided one.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
* @param pid The Product ID to set.
*/
VIGEM_API void vigem_target_set_pid(PVIGEM_TARGET target, USHORT pid);
/**
* Overrides the default Product ID value with the provided one.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
* @param pid The Product ID to set.
*/
VIGEM_API void vigem_target_set_pid(PVIGEM_TARGET target, USHORT pid);
/**
* Returns the Vendor ID of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The Vendor ID.
*/
VIGEM_API USHORT vigem_target_get_vid(PVIGEM_TARGET target);
/**
* Returns the Vendor ID of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The Vendor ID.
*/
VIGEM_API USHORT vigem_target_get_vid(PVIGEM_TARGET target);
/**
* Returns the Product ID of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The Product ID.
*/
VIGEM_API USHORT vigem_target_get_pid(PVIGEM_TARGET target);
/**
* Returns the Product ID of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The Product ID.
*/
VIGEM_API USHORT vigem_target_get_pid(PVIGEM_TARGET target);
/**
* Sends a state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report to send to the target device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_update(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, XUSB_REPORT report);
/**
* Sends a state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report to send to the target device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_update(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, XUSB_REPORT report);
/**
* Sends a state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report to send to the target device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_update(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, DS4_REPORT report);
/**
* Sends a state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report to send to the target device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_update(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, DS4_REPORT report);
/**
* Sends a full size state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 07.09.2020
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report buffer.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_update_ex(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, DS4_REPORT_EX report);
/**
* Sends a full size state report to the provided target device.
*
* @author Benjamin "Nefarius" H<>glinger-Stelzer
* @date 07.09.2020
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param report The report buffer.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_ds4_update_ex(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, DS4_REPORT_EX report);
/**
* Returns the internal index (serial number) the bus driver assigned to the provided
* target device object. Note that this value is specific to the inner workings of
* the bus driver, it does not reflect related values like player index or device
* arrival order experienced by other APIs. It may be used to identify the target
* device object for its lifetime. This value becomes invalid once the target
* device is removed from the bus and may change on the next addition of the
* device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The internally used index of the target device.
*/
VIGEM_API ULONG vigem_target_get_index(PVIGEM_TARGET target);
/**
* Returns the internal index (serial number) the bus driver assigned to the provided
* target device object. Note that this value is specific to the inner workings of
* the bus driver, it does not reflect related values like player index or device
* arrival order experienced by other APIs. It may be used to identify the target
* device object for its lifetime. This value becomes invalid once the target
* device is removed from the bus and may change on the next addition of the
* device.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns The internally used index of the target device.
*/
VIGEM_API ULONG vigem_target_get_index(PVIGEM_TARGET target);
/**
* Returns the type of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns A VIGEM_TARGET_TYPE.
*/
VIGEM_API VIGEM_TARGET_TYPE vigem_target_get_type(PVIGEM_TARGET target);
/**
* Returns the type of the provided target device object.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 28.08.2017
*
* @param target The target device object.
*
* @returns A VIGEM_TARGET_TYPE.
*/
VIGEM_API VIGEM_TARGET_TYPE vigem_target_get_type(PVIGEM_TARGET target);
/**
* Returns TRUE if the provided target device object is currently attached to the bus,
* FALSE otherwise.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 30.08.2017
*
* @param target The target device object.
*
* @returns TRUE if device is attached to the bus, FALSE otherwise.
*/
VIGEM_API BOOL vigem_target_is_attached(PVIGEM_TARGET target);
/**
* Returns TRUE if the provided target device object is currently attached to the bus,
* FALSE otherwise.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 30.08.2017
*
* @param target The target device object.
*
* @returns TRUE if device is attached to the bus, FALSE otherwise.
*/
VIGEM_API BOOL vigem_target_is_attached(PVIGEM_TARGET target);
/**
* Returns the user index of the emulated Xenon device. This value correspondents to the
* (zero-based) index number representing the player number via LED present on a
* physical controller and is compatible to the dwUserIndex property of the
* XInput* APIs.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 10.05.2018
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param index The (zero-based) user index of the Xenon device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_get_user_index(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PULONG index);
/**
* Returns the user index of the emulated Xenon device. This value correspondents to the
* (zero-based) index number representing the player number via LED present on a
* physical controller and is compatible to the dwUserIndex property of the
* XInput* APIs.
*
* @author Benjamin "Nefarius" H<>glinger
* @date 10.05.2018
*
* @param vigem The driver connection object.
* @param target The target device object.
* @param index The (zero-based) user index of the Xenon device.
*
* @returns A VIGEM_ERROR.
*/
VIGEM_API VIGEM_ERROR vigem_target_x360_get_user_index(PVIGEM_CLIENT vigem, PVIGEM_TARGET target, PULONG index);
#ifdef __cplusplus
}

3
sdk/src/Internal.h
View File

@@ -66,6 +66,5 @@ typedef struct _VIGEM_TARGET_T
VIGEM_TARGET_TYPE Type;
FARPROC Notification;
LPVOID NotificationUserData;
HANDLE cancelNotificationThreadEvent;
HANDLE CancelNotificationThreadEvent;
} VIGEM_TARGET;

22
sdk/src/ViGEmClient.cpp
View File

@@ -500,15 +500,15 @@ VIGEM_ERROR vigem_target_x360_register_notification(
target->Notification = reinterpret_cast<FARPROC>(notification);
target->NotificationUserData = userData;
if (target->cancelNotificationThreadEvent == nullptr)
target->cancelNotificationThreadEvent = CreateEvent(
if (target->CancelNotificationThreadEvent == nullptr)
target->CancelNotificationThreadEvent = CreateEvent(
nullptr,
TRUE,
FALSE,
nullptr
);
else
ResetEvent(target->cancelNotificationThreadEvent);
ResetEvent(target->CancelNotificationThreadEvent);
std::thread _async{
[](
@@ -592,15 +592,15 @@ VIGEM_ERROR vigem_target_ds4_register_notification(
target->Notification = reinterpret_cast<FARPROC>(notification);
target->NotificationUserData = userData;
if (target->cancelNotificationThreadEvent == 0)
target->cancelNotificationThreadEvent = CreateEvent(
if (target->CancelNotificationThreadEvent == 0)
target->CancelNotificationThreadEvent = CreateEvent(
nullptr,
TRUE,
FALSE,
nullptr
);
else
ResetEvent(target->cancelNotificationThreadEvent);
ResetEvent(target->CancelNotificationThreadEvent);
std::thread _async{
[](
@@ -663,13 +663,13 @@ VIGEM_ERROR vigem_target_ds4_register_notification(
void vigem_target_x360_unregister_notification(PVIGEM_TARGET target)
{
if (target->cancelNotificationThreadEvent != 0)
SetEvent(target->cancelNotificationThreadEvent);
if (target->CancelNotificationThreadEvent != 0)
SetEvent(target->CancelNotificationThreadEvent);
if (target->cancelNotificationThreadEvent != nullptr)
if (target->CancelNotificationThreadEvent != nullptr)
{
CloseHandle(target->cancelNotificationThreadEvent);
target->cancelNotificationThreadEvent = nullptr;
CloseHandle(target->CancelNotificationThreadEvent);
target->CancelNotificationThreadEvent = nullptr;
}
target->Notification = nullptr;