LibTiePie  0.5
Library for interfacing TiePie engineering instruments
 All Files Functions Typedefs Macros Modules Pages

Description

Obtain information of a device trigger input.

The following information of a device trigger input is available:

Functions

bool8_t DevTrInIsAvailable (TpDeviceHandle_t hDevice, uint16_t wInput)
 Check whether a device trigger input is available. More...
 
uint32_t DevTrInGetId (TpDeviceHandle_t hDevice, uint16_t wInput)
 Get the id of a specified device trigger input. More...
 
uint32_t DevTrInGetName (TpDeviceHandle_t hDevice, uint16_t wInput, char *pBuffer, uint32_t dwBufferLength)
 Get the name of a specified device trigger input. More...
 

Function Documentation

bool8_t DevTrInIsAvailable ( TpDeviceHandle_t  hDevice,
uint16_t  wInput 
)

Check whether a device trigger input is available.

Depending on other settings of a device, a device trigger input may be not available. E.g. when the measure mode of an oscilloscope is set to streaming, device trigger inputs are not available.

Parameters
[in]hDeviceA device handle identifying the device.
[in]wInputThe trigger input index identifying the trigger input, 0 to DevTrInGetCount() - 1.
Returns
BOOL8_TRUE if available, BOOL8_FALSE otherwise.
Status values
INVALID_INPUT The requested trigger input is not valid.
NOT_SUPPORTED The device has no trigger inputs.
INVALID_HANDLE The handle to the device is invalid.
DEVICE_GONE The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.4.4
uint32_t DevTrInGetId ( TpDeviceHandle_t  hDevice,
uint16_t  wInput 
)

Get the id of a specified device trigger input.

Parameters
[in]hDeviceA device handle identifying the device.
[in]wInputThe trigger input index identifying the trigger input, 0 to DevTrInGetCount() - 1.
Returns
The trigger input id, a TIID_* value.
Status values
INVALID_INPUT The requested trigger input is not valid.
NOT_SUPPORTED The device has no trigger inputs.
INVALID_HANDLE The handle to the device is invalid.
DEVICE_GONE The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
See also
DevTrGetInputIndexById()
Since
0.4.4
uint32_t DevTrInGetName ( TpDeviceHandle_t  hDevice,
uint16_t  wInput,
char *  pBuffer,
uint32_t  dwBufferLength 
)

Get the name of a specified device trigger input.

Parameters
[in]hDeviceA device handle identifying the device.
[in]wInputThe trigger input index identifying the trigger input, 0 to DevTrInGetCount() - 1.
[out]pBufferA pointer to a buffer for the name.
[in]dwBufferLengthThe length of the buffer, in bytes.
Returns
The length of the name in bytes, excluding terminating zero.
Status values
INVALID_INPUT The requested trigger input is not valid.
NOT_SUPPORTED The device has no trigger inputs.
INVALID_HANDLE The handle to the device is invalid.
DEVICE_GONE The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.4.1