TSPI_lineSelectExtVersion, fonction (tspi.h)
La fonction TSPI_lineSelectExtVersion sélectionne la version d’extension indiquée pour l’appareil de ligne indiqué. Les requêtes suivantes fonctionnent selon cette version d’extension.
Syntaxe
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
Paramètres
hdLine
Handle de la ligne pour laquelle une version d’extension doit être sélectionnée.
dwExtVersion
Version de l’extension à sélectionner. Ce numéro de version a été négocié à l’aide de TSPI_lineNegotiateExtVersion. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version secondaire. L’appel de cette fonction avec une valeur dwExtVersion égale à zéro annule la sélection actuelle.
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_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Remarques
Le fournisseur de services sélectionne la version d’extension indiquée. Bien que le numéro de version indiqué ait pu être négocié avec succès, une autre version d’extension a peut-être été sélectionnée entre-temps, auquel cas cette fonction échoue (renvoyant LINEERR_INCOMPATIBLEEXTVERSION).
Les opérations suivantes sur la ligne après la sélection d’une version d’extension se comportent en fonction de cette version d’extension. Les tentatives suivantes de négociation de la version de l’extension rapportent strictement la version sélectionnée ou 0 (si la plage demandée n’inclut pas la version sélectionnée). L’appel de cette procédure avec l’extension spéciale version 0 annule la sélection actuelle. L’appareil redevient capable de prendre en charge toute sa gamme de numéros de version d’extension.
Cette fonction n’a pas de correspondance directe au niveau TAPI, où la sélection d’une version d’extension est groupée avec les autres fonctionnalités de lineOpen. La fonction TSPI_lineSelectExtVersion est généralement appelée dans deux situations : (1) Une application a demandé à ouvrir une ligne, le changement résultant de la surveillance du type de média a réussi, l’application a demandé qu’une version d’extension particulière soit utilisée et aucune version d’extension n’a été sélectionnée actuellement. (2) La dernière application utilisant une version d’extension particulière a fermé la ligne et la sélection de la version d’extension peut être annulée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |