TSPI_phoneSetData, fonction (tspi.h)
La fonction TSPI_phoneSetData télécharge les informations de la mémoire tampon spécifiée sur l’appareil téléphonique ouvert à l’identificateur de données sélectionné.
Syntaxe
LONG TSPIAPI TSPI_phoneSetData(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdPhone
Handle du téléphone dans lequel les données doivent être téléchargées.
dwDataID
Spécifie où la mémoire tampon doit être téléchargée sur l’appareil téléphonique.
lpData
Pointeur vers l’emplacement de mémoire à partir duquel les données doivent être téléchargées.
dwSize
Taille de la mémoire tampon 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 dwRequestID, ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante 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_INVALDATAID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Remarques
La fonction télécharge un maximum d’octets dwSize de lpData sur l’appareil téléphonique. Le format des données, leur signification pour l’appareil téléphonique et la signification de l’identificateur de données sont spécifiques au fournisseur de services. Les données dans la mémoire tampon ou la sélection d’un identificateur de données peuvent servir de commandes à l’appareil téléphonique.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tspi.h |