| Platform SDK: TAPI |
The tapi/terminal device class consists of the phone devices associated with each terminal on a line or the terminal on each line associated with a phone device. You access these devices by using the TAPI line or phone functions.
The lineGetID function fills a VARSTRING structure, setting the dwStringFormat member to the STRINGFORMAT_BINARY value and appending this additional member:
DWORD adwDeviceId[]; // array of phone device identifiers
The adwDeviceId member is an array of phone device identifiers. There is one array element for each terminal specified by the dwNumTerminals member in the LINEDEVCAPS structure for the given line device. Each element specifies the identifier of the phone device associated with the corresponding terminal on the line. If there is no phone device associated with a terminal, the element is set to –1 (0xFFFFFFFF).
The phoneGetID function fills a VARSTRING structure, setting the dwStringFormat member to the STRINGFORMAT_BINARY value and appending this additional member:
DWORD adwTerminalID[]; // array of terminal identifiers
The adwTerminalID member is an array of terminal identifiers. There is one array element for each line device identifier specified by the lineInitialize function. Each array element contains the terminal identifier associated with the phone device for the given line device. If there is no phone device, the element is set to –1 (0xFFFFFFFF). The terminal identifiers range in value from zero to one less than the number specified by the dwNumTerminals member in the LINEDEVCAPS structure.