función TSPI_phoneSetButtonInfo (tspi.h)
La función TSPI_phoneSetButtonInfo establece información sobre el botón especificado en el teléfono especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneSetButtonInfo(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO const lpButtonInfo
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica. El proveedor de servicios devuelve este valor si la función se completa de forma asincrónica.
hdPhone
Identificador del teléfono para el que se va a establecer la información del botón.
dwButtonLampID
Un botón en el dispositivo telefónico.
lpButtonInfo
Puntero a una estructura de tamaño variable de tipo PHONEBUTTONINFO. Esta estructura de datos describe el modo y la función, y proporciona texto descriptivo adicional que se va a establecer para el botón.
Valor devuelto
Devuelve el valor dwRequestID (positivo) si la función se completa de forma asincrónica 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_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
Esta función establece el significado y el texto descriptivo asociado de los botones de un teléfono.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | tspi.h |