Compartir a través de


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

Consulte también

ASYNC_COMPLETION

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneGetButtonInfo