Description

Notifications indicating a device is removed.

LibTiePie can notify the calling application that a device is removed in different ways:

Functions
void	DevSetCallbackRemoved (LibTiePieHandle_t hDevice, TpCallback_t pCallback, void *pData)
	Set a callback function which is called when the device is removed. More...

void	DevSetEventRemoved (LibTiePieHandle_t hDevice, int fdEvent)
	Set an event file descriptor which is set when the device is removed. More...

void	DevSetEventRemoved (LibTiePieHandle_t hDevice, HANDLE hEvent)
	Set an event object handle which is set when the device is removed. More...

void	DevSetMessageRemoved (LibTiePieHandle_t hDevice, HWND hWnd, WPARAM wParam, LPARAM lParam)
	Set a window handle to which a WM_LIBTIEPIE_DEV_REMOVED message is sent when the device is removed. More...

Function Documentation

void DevSetCallbackRemoved	(	LibTiePieHandle_t	hDevice,
		TpCallback_t	pCallback,
		void *	pData
	)

Set a callback function which is called when the device is removed.

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	pCallback	A pointer to the callback function. Use `NULL` to disable.
[in]	pData	Optional user data.

Status values

INVALID_HANDLE	The handle to the device is invalid.
OBJECT_GONE	The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

Set an event file descriptor which is set when the device is removed.

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	fdEvent	An event file descriptor. Use `<0` to disable.

Status values

INVALID_HANDLE	The handle to the device is invalid.
OBJECT_GONE	The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

Set an event object handle which is set when the device is removed.

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	hEvent	A handle to the event object. Use `NULL` to disable.

Status values

INVALID_HANDLE	The handle to the device is invalid.
OBJECT_GONE	The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

Set a window handle to which a WM_LIBTIEPIE_DEV_REMOVED message is sent when the device is removed.

Deprecated:: Will be removed in future version, see: ObjSetEventWindowHandle()

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	hWnd	A handle to the window whose window procedure is to receive the message. Use `NULL` to disable.
[in]	wParam	Optional user value for the `wParam` parameter of the message.
[in]	lParam	Optional user value for the `lParam` parameter of the message.

Status values

INVALID_HANDLE	The handle to the device is invalid.
OBJECT_GONE	The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.