Device added

Description

Functions to set notifications that are triggered when a device is added to the list.

Functions
void	LstSetCallbackDeviceAdded (TpCallbackDeviceList_t pCallback, void *pData)
	Set a callback function which is called when a device is added to the device list. More...
void	LstSetEventDeviceAdded (int fdEvent)
	Set an event file descriptor which is set when a device is added to the device list. More...
void	LstSetEventDeviceAdded (HANDLE hEvent)
	Set an event object handle which is set when a device is added to the device list. More...
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. More...

Function Documentation

void LstSetCallbackDeviceAdded	(	TpCallbackDeviceList_t	pCallback,
		void *	pData
	)

Set a callback function which is called when a device is added to the device list.

Parameters

[in]	pCallback	A pointer to the callback function. Use NULL to disable.
[in]	pData	Optional user data.

Status values

LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
LIBTIEPIESTATUS_SUCCESS

Since

0.5

void LstSetEventDeviceAdded

(

int

fdEvent

)

Set an event file descriptor which is set when a device is added to the device list.

Parameters

[in]

fdEvent

An event file descriptor. Use <0 to disable.

Note

This function is only available on GNU/Linux.

Status values

LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
LIBTIEPIESTATUS_SUCCESS

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

[in]

hEvent

A handle to the event object. Use NULL to disable.

Note

This function is only available on Windows.

Status values

LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
LIBTIEPIESTATUS_SUCCESS

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

[in]

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

LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
LIBTIEPIESTATUS_SUCCESS

Since

0.4.0