LibTiePie  0.9.11
Library for interfacing TiePie engineering instruments

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.

Deprecated:
Will be removed in future version, see: ObjSetEventCallback()
Parameters
[in]hDeviceA device handle identifying the device.
[in]pCallbackA pointer to the callback function. Use NULL to disable.
[in]pDataOptional 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_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.4.0
void DevSetEventRemoved ( LibTiePieHandle_t  hDevice,
int  fdEvent 
)

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

Deprecated:
Will be removed in future version, see: ObjSetEventEvent()
Parameters
[in]hDeviceA device handle identifying the device.
[in]fdEventAn 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_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Note
This function is only available on GNU/Linux.
Since
0.4.0
void DevSetEventRemoved ( LibTiePieHandle_t  hDevice,
HANDLE  hEvent 
)

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

Deprecated:
Will be removed in future version, see: ObjSetEventEvent()
Parameters
[in]hDeviceA device handle identifying the device.
[in]hEventA 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_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Note
This function is only available on Windows.
Since
0.4.0
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.

Deprecated:
Will be removed in future version, see: ObjSetEventWindowHandle()
Parameters
[in]hDeviceA device handle identifying the device.
[in]hWndA handle to the window whose window procedure is to receive the message. Use NULL to disable.
[in]wParamOptional user value for the wParam parameter of the message.
[in]lParamOptional 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_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Note
This function is only available on Windows.
Since
0.4.0