Función phoneGetData (tapi.h)

  • Artículo

La función phoneGetData carga la información de la ubicación especificada en el dispositivo telefónico abierto al búfer especificado.

Sintaxis

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Parámetros

hPhone

Controla el dispositivo telefónico abierto.

dwDataID

Donde en el dispositivo telefónico se cargará el búfer.

lpData

Puntero al búfer de memoria donde se van a cargar los datos.

dwSize

Tamaño del búfer de datos, en bytes.

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_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Comentarios

La función carga un máximo de bytes dwSize desde el dispositivo telefónico en el área de memoria a la que apunta lpData. Si dwSize es cero, no se copia nada. El tamaño de cada área de datos se muestra en las funcionalidades del dispositivo del teléfono.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi.h
Library Tapi32.lib
Archivo DLL Tapi32.dll

Consulte también

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2