TSPI_phoneGetData, fonction (tspi.h)
La fonction TSPI_phoneGetData charge les informations de l’emplacement spécifié dans l’appareil téléphonique ouvert vers la mémoire tampon spécifiée.
Syntaxe
LONG TSPIAPI TSPI_phoneGetData(
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
Paramètres
hdPhone
Poignée au téléphone à interroger.
dwDataID
Spécifie l’emplacement à partir duquel la mémoire tampon doit être chargée sur l’appareil téléphonique.
lpData
Pointeur vers la mémoire tampon dans laquelle les données doivent être chargées.
dwSize
Taille de la mémoire tampon de données en octets. Si le paramètre lpData est un pointeur vers une chaîne, la taille doit inclure le terminateur Null .
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_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL.
Remarques
La fonction TSPI_phoneGetData charge un maximum d’octets dwSize à partir de l’appareil téléphonique dans lpData. Si dwSize est égal à zéro, rien n’est copié. La taille de chaque zone de données est répertoriée dans la structure PHONECAPS du téléphone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |