fonction TSPI_phoneOpen (tspi.h)
La fonction TSPI_phoneOpen ouvre l’appareil téléphonique dont l’identificateur d’appareil est donné, renvoyant le handle opaque du fournisseur de services pour l’appareil et conservant la poignée opaque de TAPI pour l’appareil pour l’utiliser dans les appels suivants à la procédure PHONEEVENT .
Syntaxe
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Paramètres
dwDeviceID
Appareil téléphonique à ouvrir.
htPhone
Poignée opaque TAPI pour l’appareil téléphonique à utiliser dans les appels suivants à la procédure de rappel PHONEEVENT pour identifier l’appareil.
lphdPhone
Pointeur vers un HDRVPHONE où le fournisseur de services écrit son handle pour l’appareil téléphonique à utiliser par TAPI dans les appels suivants pour identifier l’appareil.
dwTSPIVersion
La version TSPI négociée via TSPI_phoneNegotiateTSPIVersion sous laquelle le fournisseur de services peut opérer.
lpfnEventProc
Pointeur vers la procédure de rappel PHONEEVENT fournie par TAPI que le fournisseur de services appelle pour signaler les événements suivants sur le téléphone.
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_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.
Remarques
L’ouverture d’un téléphone permet à TAPI d’effectuer d’autres demandes sur le téléphone. Le téléphone devient actif dans le sens où le fournisseur de services peut signaler des événements asynchrones tels que des changements de commutateur de connexion ou des appuis de bouton. Le fournisseur de services réserve toutes les ressources non partageables requises pour gérer le téléphone. Par exemple, l’ouverture d’un téléphone accessible par le biais d’un port de communication et d’un modem doit entraîner l’ouverture du port de communication, ce qui le rend non disponible pour une utilisation par d’autres applications.
Si la fonction réussit, TAPI et le fournisseur de services s’engagent à fonctionner sous le numéro de version d’interface spécifié pour cet appareil ouvert. Les opérations et événements suivants identifiés à l’aide des handles téléphoniques opaques échangés sont conformes à cette version d’interface. Cet engagement et la validité des handles restent en vigueur jusqu’à ce que TAPI ferme le téléphone à l’aide de TSPI_phoneClose ou jusqu’à ce que le fournisseur de services signale l’événement PHONE_CLOSE . Si la fonction échoue, aucun engagement de ce type n’est pris et les handles ne sont pas valides.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |