TSPI_phoneSetDisplay, fonction (tspi.h)

Article
08/26/2023

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

Syntaxe

LONG TSPIAPI TSPI_phoneSetDisplay(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwRow,
  DWORD         dwColumn,
  LPCWSTR       lpsDisplay,
  DWORD         dwSize
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdPhone

Handle du téléphone sur lequel la chaîne doit être affichée.

dwRow

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é. L’application stocke les informations d’affichage au format spécifié sous la forme dwStringFormat dans la structure PHONECAPS du téléphone.

dwSize

Taille en octets, y compris la marque de fin Null , des informations pointées par lpDisplay.

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_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

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. Les membres dwNumRows et dwNumColumns sont disponibles dans la structure PHONECAPS retournée par TSPI_phoneGetDevCaps ; ils sont de base zéro.