fonction TSPI_providerCreateLineDevice (tspi.h)

La fonction TSPI_providerCreateLineDevice est appelée par TAPI en réponse à la réception d’un message LINE_CREATE du fournisseur de services, ce qui permet la création dynamique d’un nouvel appareil de ligne.

Syntaxe

LONG TSPIAPI TSPI_providerCreateLineDevice(
  DWORD_PTR dwTempID,
  DWORD     dwDeviceID
);

Paramètres

dwTempID

Identificateur d’appareil temporaire que le fournisseur de services a transmis à TAPI dans le message LINE_CREATE .

dwDeviceID

Identificateur d’appareil que TAPI attribue à cet appareil si cette fonction réussit.

Valeur retournée

Retourne zéro si la demande réussit ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Remarques

Lorsque TAPI reçoit un message LINE_CREATE d’un fournisseur de services, il appelle cette fonction (il n’appelle jamais cette fonction spontanément). TAPI ajoute 1 au nombre d’appareils de ce type et transmet le nouvel identificateur d’appareil inutilisé résultant en tant que paramètre dwDeviceID à cette fonction. Il transmet également à la fonction le paramètre dwParam2 du message LINE_CREATE en tant que dwTempID.

Note L’ajout du nouvel appareil à la fin de la liste des appareils est susceptible de produire des identificateurs d’appareil non incohérents pour le fournisseur de services ; les fournisseurs de services qui prennent en charge la création dynamique d’appareils doivent également prendre en charge les identificateurs d’appareil non incohérents.

 

Si le fournisseur de services reconnaît le dwTempID et réussit à configurer les structures et qu’il doit prendre en charge le nouvel appareil, il enregistre le dwDeviceID et retourne SUCCESS. Si cette fonction échoue, TAPI n’ajoute pas l’appareil et il n’y a aucun effet négatif (le message LINE_CREATE est ignoré). Si cette fonction se termine correctement, TAPI informe les applications de la disponibilité du nouvel appareil à l’aide de messages LINE_CREATE ou LINE_LINEDEVSTATE (LINEDEVSTATE_REINIT).

Toutefois, les fournisseurs de services plus anciens qui n’exportent pas cette fonction ne doivent pas non plus envoyer de messages LINE_CREATE, ce qui signifie que TAPI n’essaiera pas d’appeler cette fonction.

Configuration requise

Plateforme cible	Windows
En-tête	tspi.h

Voir aussi

LINE_CREATE

LINE_LINEDEVSTATE