TSPI_phoneGetData función (tspi.h)
La función TSPI_phoneGetData carga la información de la ubicación especificada en el dispositivo telefónico abierto al búfer especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneGetData(
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
Parámetros
hdPhone
Identificador del teléfono que se va a consultar.
dwDataID
Especifica desde dónde se cargará el búfer en el dispositivo telefónico.
lpData
Puntero al búfer de memoria en el que se cargarán los datos.
dwSize
Tamaño del búfer de datos en bytes. Si el parámetro lpData es un puntero a una cadena, el tamaño debe incluir el terminador nulo .
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL.
Comentarios
La función TSPI_phoneGetData carga un máximo de bytes dwSize desde el dispositivo telefónico en lpData. Si dwSize es cero, no se copia nada. El tamaño de cada área de datos se muestra en la estructura PHONECAPS del teléfono.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |