This property is for TAPI and TSP version negotiation.The members APIVersion, APILowVersion and APIHighVersion are used to negotiate a version to work with the TSP.
The ExtentionIDs are used to identify the TSP and it's extended services. Use the ExtLowVersion and ExtHighVersion to negotiate an extension version. The used extension verson is stored in the ExtVersion member after negotiation.
Please refer to the sections "lineNegotiatAPIVesion" and "lineNegotiateExtVersion" in TAPI's documentation for a more detailed information.
Declaration
property TSP: ThbTapiTSP;
APIVersion (DWORD)
Availability
Design-Time: None / Run-Time: Read
This is the API version which is negotiated with the TAPI Service Provider (TSP) and is used in TAPI functions.
APILowVersion (DWORD)
Availability
Design-Time: None / Run-Time: Read
This is the lowest version supported by hbTapi Components. This value is used to negotiate the version with the TAPI Service Provider (TSP) by calling the lineNegotiateAPIVersion. If the line device is available the used version is stored in the APIVersion member. If the TSP version does not match the range of APILowVersion and APIHighVersion the negotiation failed and the Available property is set to False.
APIHighVersion (DWORD)
Availability
Design-Time: None / Run-Time: Read
This is the highest version supported by hbTapi Components. This value is used to negotiate the version with the TAPI Service Provider (TSP) by calling the lineNegotiateAPIVersion. The used version is stored in the APIVersion member. If the TSP version does not match the range of APILowVersion and APIHighVersion the negotiation failed and the Available property is set to False.
ExtVersion (DWORD) |
 |
Availability
Design-Time: None / Run-Time: Read
This is the extension version which is negotiated with the TAPI Service Provider (TSP). Your application must check the ExtVersion and the ExtensionID's prior to calls of the TAPI functions lineDevSpecific and lineDevSpecificFeature.
Example
| if (ThbTapiPhone1.TSP.ExtentionID0 = $24554) and (ThbTapiPhone1.TSP.ExtentionID1
= $1364) and (ThbTapiPhone1.TSP.ExtentionID2 = $9567) and (ThbTapiPhone1.TSP.ExtentionID3 = $45) then begin // a known TSP TapiPhone1.TSP.ExtLowVersion := $00010000; TapiPhone1.TSP.ExtHighVersion := $00020000; if TapiPhone1.TSP.ExtVersion <> 0 then begin // negotiation succeeded Label1.Caption := Format('Extension version is %8.8x', [TapiPhone1.TSP.ExtVersion]); // use the value of TapiPhone1.TSP.ExtVersion to use the TSP in the right way end; end; |
ExtLowVersion (DWORD) |
|
Availability
Design-Time: Read, Write / Run-Time: Read, Write
This is the lowest extension version your application supports. This value is used to negotiate the extension version with the TAPI Service Provider (TSP) by calling the lineNegotiateExtVersion. The used version is stored in the ExtVersion member. If the TSP's extension version does not match the range of ExtLowVersion and ExtHighVersion, the negotiation failed and the ExtVersion member is set to zero.
ExtHighVersion (DWORD) |
|
Availability
Design-Time: Read, Write / Run-Time: Read, Write
This is the highest extension version your application supports.
ExtensionID0 ..3 (DWORD) |
|
Availability
Design-Time: None / Run-Time: Read
These are the ExtensionID's of the TAPI Service Provider TSP. The ExtensionID's are used to identify the extended services of a TSP. Your application must check the ExtVersion and the ExtensionID's prior to calls of the TAPI functions lineDevSpecific and lineDevSpecificFeature.