Toshiba V Series User Manual page 74

Chapter 8 Function Reference
8
62
TcnScmGetTalkerMap
Name
TcnScmGetTalkerMap - Read scan talker map
Type
#include <tcnlib.h>
BOOL TcnScmGetTalkerMap (IN HANDLE hDevice, IN OUT ScanTalkerMap
*p);
Description
Reads the scan talker map.
hDevice : File handle obtained with TcnCreateFile
The read data storage area ScanTalkerMap is the following structure. The area
must be at least as large as ScanTalkerMap size.
typedef struct MutiBlk {
BYTE
BYTE
} MutiBlk;
typedef struct ScanTalkerMap {
WORD
WORD
MutiBlk
} ScanTalkerMap;
StartBlk is the block number (0 to 2047) to start reading the scan talker map.
BlkNum is the size of the block (1 to 2048, but StartBlk+BlkNum must not
exceed 2048) to read from the block specified with StartBlk.
If the scan talker block is registered by more than one station, the duplicate
status is recorded in the scan talker map. The duplicate status is cleared by re-
registering the scan talker block so that it is not duplicated, but once the
duplicate state is recorded, it is not cleared automatically. Therefore, in order to
verify that the duplicate state is cleared, check the scan talker map after an
interval longer than the longest scan cycle has elapsed after clearing the
duplicate block in the scan talker map (after the scan talker map is updated after
clearing the duplicate state).
Return Code
TRUE is returned in case of normal end.
The scan talker block information is set in BlkInf[ ].
If Sa1 is 0 and Sa2 is 0, the block is not used.
If Sa1 is not 0 and Sa2 is 0, the block is used by the node indicated by Sa1 (1 to
254).
If Sa1 is not 0 and Sa2 is not 0, the block is used by the node indicated by Sa1
(1 to 254) and Sa2 (1 to 254) and is in a duplicate state.
FALSE is returned in case of abnormal end.
The error detail can be obtained with GetLastError().
Sa1;
Sa2;
StartBlk;
BlkNum;
BlkInf[2048];
TC-net 100 PCI Bus Card Support Software User Manual