TSPI_lineNegotiateTSPIVersion, fonction (tspi.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |