Callback mechanism. More...

Data Structures
struct	ProfisharkApiCallbackValue_DiskDump

struct	ProfisharkApiCallbackValue_DiskDumpNewFile

Typedefs
typedef void *	ProfisharkApiCallbackValue
	Profishark callback value. More...

typedef void(*	ProfisharkApiCallback )(ProfisharkApiDeviceHandle, void *)
	Callback function. More...

typedef void(*	ProfisharkApiCallbackExt )(ProfisharkApiDeviceHandle, ProfisharkApiCallbackValue , void )
	Callback function. More...

Enumerations
enum	ProfisharkApiGlobalCallbackType { ProfisharkApiGlobalCallbackType_NewDevice, ProfisharkApiGlobalCallbackType_DeviceRemoved }

enum	ProfisharkApiDeviceCallbackType { ProfisharkApiDeviceCallbackType_DiskDump, ProfisharkApiDeviceCallbackType_DiskDumpNewFile }

Functions
PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet	ProfisharkAPIAddNewDeviceCallback (ProfisharkApiCallback callback, void *context)
	Add a new function to be called when a new Profishark device is detected. More...

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet	ProfisharkAPIRemoveNewDeviceCallback (ProfisharkApiCallback callback)
	Remove a function from the list of functions called when a new Profishark device is detected. More...

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet	ProfisharkAPIAddDeviceGoneCallback (ProfisharkApiCallback callback, void *context)
	Add a new function to be called when a Profishark device is disconnected. More...

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet	ProfisharkAPIRemoveDeviceGoneCallback (ProfisharkApiCallback callback)
	Remove a function from the list of functions called when a new Profishark device is disconnected. More...

PROFISHARKAPI_API ProfisharkAPIRet	ProfisharkAPIAddGlobalCallback (ProfisharkApiGlobalCallbackType type, ProfisharkApiCallbackExt callback, void *context)
	Add a global callback function. More...

PROFISHARKAPI_API ProfisharkAPIRet	ProfisharkAPIAddDeviceCallback (ProfisharkApiDeviceHandle handle, ProfisharkApiDeviceCallbackType type, ProfisharkApiCallbackExt callback, void *context)
	Add a device callback function. More...

PROFISHARKAPI_API ProfisharkAPIRet	ProfisharkAPIRemoveGlobalCallback (ProfisharkApiGlobalCallbackType type, ProfisharkApiCallbackExt callback)
	Remove a global callback function. More...

PROFISHARKAPI_API ProfisharkAPIRet	ProfisharkAPIRemoveDeviceCallback (ProfisharkApiDeviceHandle handle, ProfisharkApiDeviceCallbackType type, ProfisharkApiCallbackExt callback)
	Remove a device callback function. More...

Detailed Description

Callback mechanism.

Typedef Documentation

typedef void(* ProfisharkApiCallback)(ProfisharkApiDeviceHandle, void *)

Callback function.

Parameters

handle	a Profishark device handle
context	a user defined value

Deprecated:: Functions using this type are deprecated. See ProfisharkApiCallbackExt.

typedef void(* ProfisharkApiCallbackExt)(ProfisharkApiDeviceHandle, ProfisharkApiCallbackValue *, void *)

Callback function.

Parameters

handle	a Profishark device handle
value	a value passed to the callback. To use it, the user has to cast it to the appropriate type depending on the callback type. See ProfisharkApiGlobalCallbackType and ProfisharkApiDeviceCallbackType
context	a user defined value

typedef void* ProfisharkApiCallbackValue

Profishark callback value.

Opaque type used by callback functions. To be used, this needs to be cast to the proper type depending on the callback type

Enumeration Type Documentation

enum ProfisharkApiDeviceCallbackType

\ brief Device specific callback types

Enumerator
ProfisharkApiDeviceCallbackType_DiskDump	Function is called on direct capture events (capture start, capture stop). ProfisharkApiCallbackValue is to be cast as ProfisharkApiCallbackValue_DiskDump
ProfisharkApiDeviceCallbackType_DiskDumpNewFile	Function is called when a new file has been created by direct capture. ProfisharkApiCallbackValue is to be cast as ProfisharkApiCallbackValue_DiskDumpNewFile

enum ProfisharkApiGlobalCallbackType

\ brief Global callback types

Enumerator
ProfisharkApiGlobalCallbackType_NewDevice	Function is called on device insertion. ProfisharkApiCallbackValue is not used
ProfisharkApiGlobalCallbackType_DeviceRemoved	Function is called on device removal. ProfisharkApiCallbackValue is not used

Function Documentation

PROFISHARKAPI_API ProfisharkAPIRet ProfisharkAPIAddDeviceCallback	(	ProfisharkApiDeviceHandle	handle,
		ProfisharkApiDeviceCallbackType	type,
		ProfisharkApiCallbackExt	callback,
		void *	context
	)

Add a device callback function.

Parameters

handle	a handle to the device
type	the type of callback to add. This defines when the function is called.
callback	the function to be called
context	a pointer passed to the callback function

Return values

ProfisharkAPIRet_Success on success

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet ProfisharkAPIAddDeviceGoneCallback	(	ProfisharkApiCallback	callback,
		void *	context
	)

Add a new function to be called when a Profishark device is disconnected.

Parameters

callback	the function to be called
context	the parameter passed to the function to be called

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_Exist	if the function is already registered

Deprecated:: Deprecated, use ProfisharkAPIAddGlobalCallback

PROFISHARKAPI_API ProfisharkAPIRet ProfisharkAPIAddGlobalCallback	(	ProfisharkApiGlobalCallbackType	type,
		ProfisharkApiCallbackExt	callback,
		void *	context
	)

Add a global callback function.

Parameters

type	the type of callback to add. This defines when the function is called.
callback	the function to be called
context	a pointer passed to the callback function

Return values

ProfisharkAPIRet_Success on success

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet ProfisharkAPIAddNewDeviceCallback	(	ProfisharkApiCallback	callback,
		void *	context
	)

Add a new function to be called when a new Profishark device is detected.

Parameters

callback	the function to be called
context	the parameter passed to the function to be called

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_Exist	if the function is already registered

Deprecated:: Deprecated, use ProfisharkAPIAddGlobalCallback

PROFISHARKAPI_API ProfisharkAPIRet ProfisharkAPIRemoveDeviceCallback	(	ProfisharkApiDeviceHandle	handle,
		ProfisharkApiDeviceCallbackType	type,
		ProfisharkApiCallbackExt	callback
	)

Remove a device callback function.

Parameters

handle	a handle to the device
type	the type of callback to remove. Must be the same as the one used for the ProfisharkAPIAddDeviceCallback call.
callback	the function to be removed

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_NotExist	if the function was not registered

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet ProfisharkAPIRemoveDeviceGoneCallback ( ProfisharkApiCallback callback )

Remove a function from the list of functions called when a new Profishark device is disconnected.

Parameters

callback the function to be removed

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_NotExist	if the function was not registered

Deprecated:: Deprecated, use ProfisharkAPIRemoveGlobalCallback

PROFISHARKAPI_API ProfisharkAPIRet ProfisharkAPIRemoveGlobalCallback	(	ProfisharkApiGlobalCallbackType	type,
		ProfisharkApiCallbackExt	callback
	)

Remove a global callback function.

Parameters

type	the type of callback to remove. Must be the same as the one used for the ProfisharkAPIAddGlobalCallback call.
callback	the function to be removed

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_NotExist	if the function was not registered

PROFISHARKAPI_API_DEPRECATED ProfisharkAPIRet ProfisharkAPIRemoveNewDeviceCallback ( ProfisharkApiCallback callback )

Remove a function from the list of functions called when a new Profishark device is detected.

Parameters

callback the function to be removed

Return values

ProfisharkAPIRet_Success	on success
ProfisharkAPIRet_NotExist	if the function was not registered

Deprecated:: Deprecated, use ProfisharkAPIRemoveGlobalCallback

Data Structures

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation