Description

Events indicating a device is removed.

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

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

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

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

void	DevSetMessageRemoved (TpDeviceHandle_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	(	TpDeviceHandle_t	hDevice,
		TpCallback_t	pCallback,
		void *	pData
	)

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

Parameters

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

Status values

INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

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

Parameters

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

Status values

INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

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

Parameters

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

Status values

INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

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

Parameters

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

Status values

INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.