Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function returns the highest SPI version the service provider can operate under for this device, given the range of possible SPI versions.
LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(DWORDdwDeviceID,DWORDdwLowVersion,DWORDdwHighVersion,LPDWORDlpdwTSPIVersion);
Parameters
- dwDeviceID
Line device for which interface version negotiation is to be performed. In addition to device identifiers within the range the service provider supports, this may be the valueINITIALIZE_NEGOTIATION. This value is used to signify that an overall interface version is to be negotiated. - dwLowVersion
Lowest TSPI version number under which TAPI can operate. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. - dwHighVersion
Highest TSPI version number under which TAPI can operate. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. - lpdwTSPIVersion
Pointer to a DWORD. The service provider fills this location with the highest TSPI version number, within the range requested by the caller, under which the service provider can operate. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. If the requested range does not overlap the range supported by the service provider, the function returns LINEERR_INCOMPATIBLEAPIVERSION.
Return Values
Returns zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this function.
| Value | Description |
|---|---|
| LINEERR_INCOMPATIBLEAPIVERSION | The API version is incompatible. |
| LINEERR_OPERATIONUNAVAIL | The operation is unavailable. |
| LINEERR_NODRIVER | The driver cannot be found. |
| LINEERR_OPERATIONFAILED | The operation failed. |
| LINEERR_NOMEM | Not enough memory is available. |
| LINEERR_RESOURCEUNAVAIL | The resource is unavailable. |
Remarks
When dwDeviceID is INITIALIZE_NEGOTIATION, this function must not return LINEERR_OPERATIONUNAVAIL, because this function (with that value) is mandatory for negotiating the overall interface version even if the service provider supports no line devices.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Tapicomn.h.
Link Library: Coredll.lib.
See Also
TSPI_lineGetExtensionID | TSPI_lineNegotiateExtVersion | TSPI_providerInit
Send Feedback on this topic to the authors