Info

Description

Obtain information of a device trigger output.

The following information of a device trigger output is available:

• ID
• Name

Functions
uint32_t	DevTrOutGetId (TpDeviceHandle_t hDevice, uint16_t wOutput)
	Get the id of a specified device trigger output. More...
uint32_t	DevTrOutGetName (TpDeviceHandle_t hDevice, uint16_t wOutput, char *pBuffer, uint32_t dwBufferLength)
	Get the name of a specified device trigger output. More...

Function Documentation

uint32_t DevTrOutGetId	(	TpDeviceHandle_t	hDevice,
		uint16_t	wOutput
	)

Get the id of a specified device trigger output.

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	wOutput	The trigger output index identifying the trigger output, 0 to DevTrOutGetCount() - 1.

Returns

The trigger output id, a TOID_* value.

Status values

INVALID_OUTPUT	The requested trigger output is not valid.
NOT_SUPPORTED	The device has no trigger outputs.
INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also

DevTrGetOutputIndexById()

Since

0.4.4

uint32_t DevTrOutGetName	(	TpDeviceHandle_t	hDevice,
		uint16_t	wOutput,
		char *	pBuffer,
		uint32_t	dwBufferLength
	)

Get the name of a specified device trigger output.

Parameters

[in]	hDevice	A device handle identifying the device.
[in]	wOutput	The trigger output index identifying the trigger output, 0 to DevTrOutGetCount() - 1.
[out]	pBuffer	A pointer to a buffer for the name.
[in]	dwBufferLength	The length of the buffer, in bytes.

Returns

The length of the name in bytes, excluding terminating zero.

Status values

INVALID_OUTPUT	The requested trigger output is not valid.
NOT_SUPPORTED	The device has no trigger outputs.
INVALID_HANDLE	The handle to the device is invalid.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

Since

0.4.1