phoneSetDisplay, fonction (tapi.h)

Article
08/26/2023

La fonction phoneSetDisplay entraîne l’affichage de la chaîne spécifiée sur l’appareil téléphonique ouvert spécifié.

Syntaxe

LONG phoneSetDisplay(
  HPHONE hPhone,
  DWORD  dwRow,
  DWORD  dwColumn,
  LPCSTR lpsDisplay,
  DWORD  dwSize
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert. L’application doit être propriétaire du téléphone.

dwRow

Position de ligne sur l’affichage où le nouveau texte doit être affiché.

dwColumn

Position de colonne sur l’affichage où le nouveau texte doit être affiché.

lpsDisplay

Pointeur vers l’emplacement de mémoire où le contenu d’affichage est stocké. Les informations d’affichage doivent avoir le format spécifié dans le membre dwStringFormat de la structure PHONECAPS , qui décrit les fonctionnalités de l’appareil du téléphone.

dwSize

Taille des informations pointées par lpsDisplay, en octets. Si le paramètre lpsDisplay est un pointeur vers une chaîne, la taille doit inclure la marque de fin Null.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un nombre d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_INVALPARAM, PHONEERR_RESOURCEUNAVAIL.

Remarques

Les informations d’affichage spécifiées sont écrites dans l’affichage du téléphone, en commençant aux positions spécifiées. Cette opération remplace les informations affichées précédemment. Si la quantité d’informations dépasse la taille de l’affichage, les informations sont tronquées. La quantité d’informations qui peuvent être affichées est au maximum d’éléments (dwNumRows * dwNumColumns) de taille. dwNumRows et dwNumColumns sont disponibles dans la structure PHONECAPS , qui est retournée par phoneGetDevCaps ; ils sont de base zéro.