TSPI_providerCreatePhoneDevice fonction (tspi.h)
La fonction TSPI_providerCreatePhoneDevice est appelée par TAPI en réponse à la réception d’un message PHONE_CREATE du fournisseur de services, ce qui permet la création dynamique d’un nouvel appareil téléphonique.
Syntaxe
LONG TSPIAPI TSPI_providerCreatePhoneDevice(
DWORD_PTR dwTempID,
DWORD dwDeviceID
);
Paramètres
dwTempID
Identificateur d’appareil temporaire que le fournisseur de services a transmis à TAPI dans le message PHONE_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 des constantes PHONEERR_ sont les suivantes :
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED.
Remarques
Quand TAPI reçoit un message PHONE_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 PHONE_CREATE en tant que dwTempID. 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 paramètre 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 PHONE_CREATE est ignoré). Si cette fonction se termine correctement, TAPI informe les applications de la disponibilité du nouvel appareil à l’aide de messages PHONE_CREATE ou PHONE_STATE (PHONESTATE_REINIT).
Toutefois, les anciens fournisseurs de services qui n’exportent pas cette fonction ne doivent pas non plus envoyer de messages PHONE_CREATE, ce qui signifie que TAPI n’essaie pas d’appeler cette fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |