TMNext Overview Group

This TMNext API call finds the next multi-drop device on the 1-Wire network specified with the session_handle. A ROM search algorithm is used to find the next unique registration number (ROM) data pattern on the 1-Wire network. The ROM data pattern that was found is stored in an internal eight byte buffer. The internal eight byte buffer can be read using the TMRom API call. After the last device on the 1-Wire network is found the next call to TMNext will return a 0. When TMNext returns a 0, the search algorithm will be reset and the next call to TMNext will be equivilant to a call to TMFirst.


short far pascal TMNext(

long session_handle,     // session handle for the desired 1-Wire network
void far *state_buffer   // state buffer provided for the 1-Wire network session
);

For a description of the above types, see the TMEX Type Descriptions.

Parameters

session_handle

Specifies the session handle returned from the API function TMExtendedStartSession that specifies the desired 1-Wire network port. This parameter is required by most TMEX API functions.

state_buffer

Specifies a pointer to a memory location that TMEX keeps all of the state information for the 1-Wire networks. This parameter is required by most TMEX API functions.

Return Value

0 => device not found

1 => next device on the 1-Wire network found

<0 => TMEX Network Error Return Code

Code Example

See Also

TMFirst, TMRom, TMNextAlarm