fonction phoneGetData (tapi.h)

  • Article

La fonction 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 phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert.

dwDataID

Emplacement à partir de l’appareil téléphonique à partir duquel la mémoire tampon doit être chargée.

lpData

Pointeur vers la mémoire tampon où les données doivent être chargées.

dwSize

Taille de la mémoire tampon de données, en octets.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Remarques

La fonction charge un maximum d’octets dwSize à partir de l’appareil téléphonique dans la zone mémoire pointée par lpData. Si dwSize est égal à zéro, rien n’est copié. La taille de chaque zone de données est répertoriée dans les fonctionnalités de l’appareil du téléphone.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2