TSPI_lineNegotiateTSPIVersion, fonction (tspi.h)

Article
03/03/2024

La fonction TSPI_lineNegotiateTSPIVersion retourne la version SPI la plus élevée sous laquelle le fournisseur de services peut opérer pour cet appareil, compte tenu de la plage de versions SPI possibles.

Syntaxe

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Paramètres

dwDeviceID

Identifie l’appareil de ligne pour lequel la négociation de version d’interface doit être effectuée. Outre les identificateurs d’appareil dans la plage prise en charge par le fournisseur de services, il peut s’agir de la valeur :

INITIALIZE_NEGOTIATION

Cette valeur est utilisée pour indiquer qu’une version globale de l’interface doit être négociée.

dwLowVersion

Numéro de version TSPI le plus bas sous lequel TAPI peut fonctionner. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure.

dwHighVersion

Numéro de version TSPI le plus élevé sous lequel TAPI peut fonctionner. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure.

lpdwTSPIVersion

Pointeur vers un DWORD. Le fournisseur de services remplit cet emplacement avec le numéro de version TSPI le plus élevé, dans la plage demandée par l’appelant, sous laquelle le fournisseur de services peut opérer. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure. Si la plage demandée ne chevauche pas la plage prise en charge par le fournisseur de services, la fonction retourne LINEERR_INCOMPATIBLEAPIVERSION.

Valeur retournée

Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Remarques

Lorsque dwDeviceID est INITIALIZE_NEGOTIATION, cette fonction ne doit pas retourner LINEERR_OPERATIONUNAVAIL, car cette fonction (avec cette valeur) est obligatoire pour la négociation de la version globale de l’interface, même si le fournisseur de services ne prend en charge aucun périphérique de ligne.