fonction TSPI_phoneNegotiateTSPIVersion (tspi.h)

Article
08/26/2023

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

Syntaxe

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

Paramètres

dwDeviceID

Appareil téléphonique pour lequel la négociation de version d’interface doit être effectuée. Les valeurs autorisées se trouvent strictement dans la plage des identificateurs des appareils téléphoniques pour ce fournisseur de services; la valeur INITIALIZE_NEGOTIATION n’est jamais passée à cette fonction.

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 principal et 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 principal et le moins significatif est le numéro de version mineure.

lpdwTSPIVersion

Pointeur vers un DWORD. Une fois le retour réussi de cette fonction, 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 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_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 :

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Remarques

Le fournisseur de services retourne PHONEERR_OPERATIONUNAVAIL si l’opération n’est pas disponible. Toutefois, si le fournisseur de services prend en charge les appareils téléphoniques, il doit également prendre en charge cette fonction et la fonction ne doit pas retourner PHONEERR_OPERATIONUNAVAIL.

TAPI appelle cette fonction au début de la séquence d’initialisation pour chaque appareil téléphonique.

La négociation d’une version d’extension s’effectue via la procédure distincte TSPI_phoneNegotiateExtVersion.

La fonction correspondante au niveau TAPI est une fonction surchargée qui récupère également l’identificateur d’extension, le cas échéant, pris en charge par le fournisseur de services. Au niveau du TSPI, la récupération de l’identificateur d’extension s’effectue par le biais d’une procédure distincte, à savoir TSPI_phoneGetExtensionID.