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

Voir aussi

TSPI_phoneNegotiateTSPIVersion