Skip to content

Latest commit

 

History

History
96 lines (71 loc) · 4.2 KB

nf-tspi-tspi_linenegotiateextversion.md

File metadata and controls

96 lines (71 loc) · 4.2 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tspi.TSPI_lineNegotiateExtVersion
TSPI_lineNegotiateExtVersion function (tspi.h)
The TSPI_lineNegotiateExtVersion function returns the highest extension version number the service provider can operate under for this device, given the range of possible extension versions.
TSPI_lineNegotiateExtVersion
TSPI_lineNegotiateExtVersion function [TAPI 2.2]
_tspi_tspi_linenegotiateextversion
tspi.tspi_linenegotiateextversion
tspi/TSPI_lineNegotiateExtVersion
tspi\tspi_linenegotiateextversion.htm
tapi3
cd7cc421-3efb-4fe1-858c-4d894f4d9377
12/05/2018
TSPI_lineNegotiateExtVersion, TSPI_lineNegotiateExtVersion function [TAPI 2.2], _tspi_tspi_linenegotiateextversion, tspi.tspi_linenegotiateextversion, tspi/TSPI_lineNegotiateExtVersion
tspi.h
Windows
Windows
19H1
TSPI_lineNegotiateExtVersion
tspi/TSPI_lineNegotiateExtVersion
c++
APIRef
kbSyntax
UserDefined
Tspi.h
TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateExtVersion function

-description

The TSPI_lineNegotiateExtVersion function returns the highest extension version number the service provider can operate under for this device, given the range of possible extension versions.

-parameters

-param dwDeviceID

Identifies the line device for which interface version negotiation is to be performed. The value INITIALIZE_NEGOTIATION may not be used for this function.

-param dwTSPIVersion

An interface version number that has already been negotiated for this device using TSPI_lineNegotiateTSPIVersion. This function operates according to the interface specification at this version level.

-param dwLowVersion

The lowest extension version number under which TAPI or its client application can operate. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. TAPI does not validate this parameter when this function is called.

-param dwHighVersion

The highest extension version number under which TAPI or its client application can operate. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. TAPI does not validate this parameter when this function is called.

-param lpdwExtVersion

A pointer to a DWORD. Upon a successful return from this function, the service provider fills this location with the highest extension 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_INCOMPATIBLEEXTVERSION.

-returns

Returns zero if the function succeeds, or an error number if an error occurs. Possible return values are as follows:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

-remarks

This function can be called before or after the device is opened by TAPI. If the device is currently open and has an extension version selected, the function gives that version number if it is within the requested range. If the selected version number is outside the requested range, the function returns LINEERR_INCOMPATIBLEEXTVERSION.

-see-also

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion