fonction TSPI_phoneSetButtonInfo (tspi.h)
La fonction TSPI_phoneSetButtonInfo définit des informations sur le bouton spécifié sur le téléphone spécifié.
Syntaxe
LONG TSPIAPI TSPI_phoneSetButtonInfo(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO const lpButtonInfo
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone. Le fournisseur de services retourne cette valeur si la fonction se termine de manière asynchrone.
hdPhone
Handle du téléphone pour lequel les informations de bouton doivent être définies.
dwButtonLampID
Bouton sur l’appareil téléphonique.
lpButtonInfo
Pointeur vers une structure de taille variable de type PHONEBUTTONINFO. Cette structure de données décrit le mode et la fonction, et fournit du texte descriptif supplémentaire à définir pour le bouton.
Valeur retournée
Retourne la valeur (positive) dwRequestID si la fonction est terminée de manière asynchrone, ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Remarques
Cette fonction définit la signification et le texte descriptif associé des boutons d’un téléphone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |