Función phoneSetDisplay (tapi.h)

Artículo
03/13/2024

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

Sintaxis

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

Parámetros

hPhone

Controla el dispositivo telefónico abierto. La aplicación debe ser el propietario del teléfono.

dwRow

Posición de 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 información de presentación debe tener el formato especificado en el miembro dwStringFormat de la estructura PHONECAPS , que describe las funcionalidades del dispositivo del teléfono.

dwSize

Tamaño de la información a la que apunta lpsDisplay, en bytes. Si el parámetro lpsDisplay es un puntero a una cadena, el tamaño debe incluir el terminador null.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de PHONE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

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

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) elementos de tamaño. dwNumRows y dwNumColumns están disponibles en la estructura PHONECAPS , que devuelve phoneGetDevCaps; son de base cero.