fonction TSPI_phoneGetDevCaps (tspi.h)
La fonction TSPI_phoneGetDevCaps interroge un appareil téléphonique spécifié pour déterminer ses capacités de téléphonie.
Syntaxe
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
Paramètres
dwDeviceID
Appareil téléphonique à interroger.
dwTSPIVersion
Numéro de version TSPI négocié. Cette valeur est négociée pour cet appareil via la fonction TSPI_phoneNegotiateTSPIVersion .
dwExtVersion
Numéro de version de l’extension négociée. Cette valeur est négociée pour cet appareil via la fonction TSPI_phoneNegotiateExtVersion .
lpPhoneCaps
Pointeur vers la mémoire dans lequel le fournisseur de services écrit une structure de taille variable de type PHONECAPS. Une fois la demande terminée, cette structure est remplie d’informations sur la capacité de l’appareil téléphonique. Avant d’appeler TSPI_phoneGetDevCaps, l’application définit le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible sur TAPI pour retourner des informations.
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
Le fournisseur de services remplit tous les membres de la structure de données PHONEBUTTONINFO , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .
Si dwExtVersion est égal à zéro, aucune information d’extension n’est demandée. S’il n’est pas nul, il contient une valeur qui a déjà été négociée pour cet appareil avec la fonction TSPI_phoneNegotiateExtVersion . Le fournisseur de services renseigne des informations étendues spécifiques à l’appareil et au fournisseur en fonction de la version d’extension spécifiée.
Une fois que le fournisseur de services est retourné à partir de la fonction TSPI_phoneGetDevCaps , TAPI définit le membre dwPhoneStates de la structure PHONECAPS comme suit :
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |