Functions to set events that are triggered when the device list is changed.
LibTiePie can inform the calling application that the device list is changed in different ways:
- by calling callback functions
- by setting events
- by sending messages (Windows only)
| void LstSetCallbackDeviceAdded |
( |
TpCallback_t |
pCallback, |
|
|
void * |
pData |
|
) |
| |
Set a callback function which is called when a device is added to the device list.
- Parameters
-
| pCallback | A pointer to the callback function. Use NULL to disable. |
| pData | Optional user data. |
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetCallbackDeviceRemoved |
( |
TpCallback_t |
pCallback, |
|
|
void * |
pData |
|
) |
| |
Set a callback function which is called when a device is removed from the device list.
- Parameters
-
| pCallback | A pointer to the callback function. Use NULL to disable. |
| pData | Optional user data. |
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetEventDeviceAdded |
( |
int |
fdEvent | ) |
|
Set an event file descriptor which is set when a device is added to the device list.
- Parameters
-
| fdEvent | An event file descriptor. Use <0 to disable. |
- Note
- This function is only available on GNU/Linux.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetEventDeviceRemoved |
( |
int |
fdEvent | ) |
|
Set an event file descriptor which is set when a device is removed from the device list.
- Parameters
-
| fdEvent | an event file descriptor. Use <0 to disable. |
- Note
- This function is only available on GNU/Linux.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetEventDeviceAdded |
( |
HANDLE |
hEvent | ) |
|
Set an event object handle which is set when a device is added to the device list.
- Parameters
-
| hEvent | A handle to the event object. Use NULL to disable. |
- Note
- This function is only available on Windows.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetEventDeviceRemoved |
( |
HANDLE |
hEvent | ) |
|
Set an event object handle which is set when a device is removed from the device list.
- Parameters
-
| hEvent | A handle to the event object. Use NULL to disable. |
- Note
- This function is only available on Windows.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetMessageDeviceAdded |
( |
HWND |
hWnd | ) |
|
Set a window handle to which a WM_LIBTIEPIE_LST_DEVICEADDED message is sent when a device is added to the device list.
The parameters of the message contain the following:
wParam contains the device types.lParam contains the serial number of the added device.
- Parameters
-
| hWnd | A handle to the window whose window procedure is to receive the message. Use NULL to disable. |
- Note
- This function is only available on Windows.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
| void LstSetMessageDeviceRemoved |
( |
HWND |
hWnd | ) |
|
Set a window handle to which a WM_LIBTIEPIE_LST_DEVICEREMOVED message is sent when a device is removed from the device list.
The parameters of the message contain the following:
wParam contains the device types.lParam contains the serial number of the removed device.
- Parameters
-
| hWnd | A handle to the window whose window procedure is to receive the message. Use NULL to disable. |
- Note
- This function is only available on Windows.
- Status values
| SUCCESS | The function executed successfully. |
- Since
- 0.4.0
1.8.8