funzione TSPI_phoneSetButtonInfo (tspi.h)

La funzione TSPI_phoneSetButtonInfo imposta le informazioni sul pulsante specificato nel telefono specificato.

Sintassi

LONG TSPIAPI TSPI_phoneSetButtonInfo(
  DRV_REQUESTID           dwRequestID,
  HDRVPHONE               hdPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Parametri

dwRequestID

Identificatore della richiesta asincrona. Il provider di servizi restituisce questo valore se la funzione viene completata in modo asincrono.

hdPhone

Handle per il telefono per cui impostare le informazioni sul pulsante.

dwButtonLampID

Pulsante sul dispositivo telefonico.

lpButtonInfo

Puntatore a una struttura di dimensioni variabile di tipo PHONEBUTTONINFO. Questa struttura di dati descrive la modalità e la funzione e fornisce testo descrittivo aggiuntivo da impostare per il pulsante.

Valore restituito

Restituisce il valore dwRequestID (positivo) se la funzione viene completata in modo asincrono o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o è un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Commenti

Questa funzione imposta il significato e il testo descrittivo associato dei pulsanti di un telefono.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

ASYNC_COMPLETION

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneGetButtonInfo