TBApiGetDeviceFromSegment API Call

Description	Gets the device handle using the name of it's logical screen segment.
Parameters	Name of segment.
Returns	The device handle or a value of TB_INVALID_HANDLE_VALUE means that the requested device does not exist.
Notes	None.
See also	A number of functions require a device handle. The following family of functions provide valid device handle’s:
	TBApiGetRelativeDevice	Get device handle from position
	TBApiGetRelativeDeviceFromHandle	Get position from device handle
	TBApiGetNamedDevice	Get device handle from named device
	TBApiGetDeviceFromSegment	Get device handle from segment

Visual C++ Declaration/example

HTBDEVICE TBAPI TBApiGetDeviceFromSegment(const TCHAR* aSegment);

HTBDEVICE device = TBApiGetDeviceFromSegment(_T("Left Half"));

Visual Basic Declaration/example

Public Declare Function TBApiGetDeviceFromSegment Lib "TBapi" Alias "_DLL_TBApiGetDeviceFromSegment@4" (ByVal aSegment as String) as Byte

Dim device As Byte

device = TBApiGetDeviceFromSegment("Left Half")