Data ready

Description

Functions to set notifications that are triggered when the oscilloscope has new measurement data ready.

Functions
void	ScpSetCallbackDataReady (LibTiePieHandle_t hDevice, TpCallback_t pCallback, void *pData)
	Set a callback function which is called when the oscilloscope has new measurement data ready. More...
void	ScpSetEventDataReady (LibTiePieHandle_t hDevice, int fdEvent)
	Set an event file descriptor which is set when the oscilloscope has new measurement data ready. More...
void	ScpSetEventDataReady (LibTiePieHandle_t hDevice, HANDLE hEvent)
	Set an event object handle which is set when the oscilloscope has new measurement data ready. More...
void	ScpSetMessageDataReady (LibTiePieHandle_t hDevice, HWND hWnd, WPARAM wParam, LPARAM lParam)
	Set a window handle to which a WM_LIBTIEPIE_SCP_DATAREADY message is sent when the oscilloscope has new measurement data ready. More...

Function Documentation

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

Set a callback function which is called when the oscilloscope has new measurement data ready.

Deprecated:

Will be removed in future version, see: ObjSetEventCallback()

Parameters

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

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
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.

See also

ScpIsDataReady

Since

0.4.0

void ScpSetEventDataReady	(	LibTiePieHandle_t	hDevice,
		int	fdEvent
	)

Set an event file descriptor which is set when the oscilloscope has new measurement data ready.

Deprecated:

Will be removed in future version, see: ObjSetEventEvent()

Parameters

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

Note

This function is only available on GNU/Linux.

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
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.

See also

ScpIsDataReady

Since

0.4.0

void ScpSetEventDataReady	(	LibTiePieHandle_t	hDevice,
		HANDLE	hEvent
	)

Set an event object handle which is set when the oscilloscope has new measurement data ready.

Deprecated:

Will be removed in future version, see: ObjSetEventEvent()

Parameters

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

Note

This function is only available on Windows.

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
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.

See also

ScpIsDataReady

Since

0.4.0

void ScpSetMessageDataReady	(	LibTiePieHandle_t	hDevice,
		HWND	hWnd,
		WPARAM	wParam,
		LPARAM	lParam
	)

Set a window handle to which a WM_LIBTIEPIE_SCP_DATAREADY message is sent when the oscilloscope has new measurement data ready.

Deprecated:

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

Parameters

[in]	hDevice	A device handle identifying the oscilloscope.
[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.

Note

This function is only available on Windows.

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
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.

See also

ScpIsDataReady

Since

0.4.0