TSPI_phoneNegotiateExtVersion fonction (tspi.h)
La fonction TSPI_phoneNegotiateExtVersion retourne le numéro de version d’extension le plus élevé sous lequel le fournisseur de services peut fonctionner pour cet appareil, compte tenu de la plage de versions d’extension possibles.
Syntaxe
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Paramètres
dwDeviceID
Identifie l’appareil téléphonique pour lequel la négociation de version d’interface doit être effectuée.
dwTSPIVersion
Spécifie un numéro de version d’interface qui est négocié pour cet appareil à l’aide de TSPI_phoneNegotiateTSPIVersion. Cette fonction fonctionne selon la spécification de l’interface à ce niveau de version.
dwLowVersion
Numéro de version d’extension le plus bas sous lequel TAPI ou son application cliente peut fonctionner. Le mot le plus significatif est le numéro de version principal et le mot le moins significatif est le numéro de version secondaire.
dwHighVersion
Numéro de version d’extension le plus élevé sous lequel TAPI ou son application cliente peut fonctionner. Le mot le plus significatif est le numéro de version principal et le mot le moins significatif est le numéro de version secondaire.
lpdwExtVersion
Pointeur vers un DWORD. En cas de retour réussi de cette fonction, le fournisseur de services remplit cet emplacement avec le numéro de version d’extension le plus élevé, dans la plage demandée par l’appelant, sous lequel le fournisseur de services peut fonctionner. Le mot le plus significatif est le numéro de version principal et le mot le moins significatif est le numéro de version secondaire. Si la plage demandée ne chevauche pas la plage prise en charge par le fournisseur de services, la fonction retourne PHONEERR_INCOMPATIBLEEXTVERSION.
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 :
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Remarques
Cette fonction peut être appelée avant ou après l’ouverture de l’appareil par TAPI. Si l’appareil est actuellement ouvert et qu’une version d’extension est sélectionnée, la fonction doit retourner ce numéro de version s’il se trouve dans la plage demandée. Si le numéro de version sélectionné est en dehors de la plage demandée, la fonction retourne PHONEERR_INCOMPATIBLEEXTVERSION.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |