Función phoneGetDisplay (tapi.h)

Artículo
03/08/2023

La función phoneGetDisplay devuelve el contenido actual de la pantalla de teléfono especificada.

Sintaxis

LONG phoneGetDisplay(
  HPHONE      hPhone,
  LPVARSTRING lpDisplay
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto.

lpDisplay

Puntero a la ubicación de memoria donde se va a almacenar el contenido para mostrar, de tipo VARSTRING.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

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

Comentarios

El área de memoria lpDisplay debe ser al menos (dwDisplayNumRows * dwDisplayNumColumns) de tamaño para recibir toda la información de visualización. Los miembros dwDisplayNumRows y dwDisplayNumColumns están disponibles en la estructura PHONECAPS devuelta por phoneGetDevCaps.