función TSPI_phoneSetDisplay (tspi.h)

Artículo
08/26/2023

La función TSPI_phoneSetDisplay hace que la cadena especificada se muestre en el dispositivo telefónico abierto especificado.

Sintaxis

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

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdPhone

Identificador del teléfono en el que se va a mostrar la cadena.

dwRow

Fila en la pantalla donde se va a mostrar el nuevo texto.

dwColumn

Posición de columna en la pantalla donde se va a mostrar el nuevo texto.

lpsDisplay

Puntero a la ubicación de memoria donde se almacena el contenido para mostrar. La aplicación almacena la información de presentación en el formato especificado como dwStringFormat en la estructura PHONECAPS del teléfono.

dwSize

Tamaño en bytes, incluido el terminador NULL , de la información a la que apunta lpDisplay.

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o es un número de error si se produce un error. Los valores devueltos posibles son los siguientes:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Comentarios

La información de visualización especificada se escribe en la pantalla del teléfono, empezando por las posiciones especificadas. Esta operación sobrescribe la información mostrada anteriormente. Si la cantidad de información supera el tamaño de la pantalla, la información se trunca. La cantidad de información que se puede mostrar es como máximo (dwNumRows * dwNumColumns) de tamaño. Los miembros dwNumRows y dwNumColumns están disponibles en la estructura PHONECAPS devuelta por TSPI_phoneGetDevCaps; son de base cero.