funzione TSPI_phoneGetStatus (tspi.h)
La funzione TSPI_phoneGetStatus esegue una query sul dispositivo telefonico aperto specificato per verificarne lo stato complessivo.
Sintassi
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Parametri
hdPhone
Handle per il telefono su cui eseguire una query.
lpPhoneStatus
Puntatore a una struttura di dati di dimensioni variabile di tipo PHONESTATUS, in cui il provider di servizi scrive informazioni sullo stato del telefono. Prima di chiamare TSPI_phoneGetStatus, l'applicazione imposta il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.
Valore restituito
Restituisce 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_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Commenti
La tabella seguente indica i membri della struttura dei dati PHONESTATUS compilati da TAPI e i membri compilati dal provider di servizi. Il provider di servizi non deve sovrascrivere i valori compilati da TAPI.
Membro | TAPI | Provider di servizi |
---|---|---|
dwTotalSize; | X | |
dwNeededSize; | X | |
dwUsedSize; | X | |
dwStatusFlags; | X | |
dwNumOwners; | X | |
dwNumMonitors; | X | |
dwRingMode; | X | |
dwRingVolume; | X | |
dwHandsetHookSwitchMode; | X | |
dwHandsetVolume; | X | |
dwHandsetGain; | X | |
dwSpeakerHookSwitchMode; | X | |
dwSpeakerVolume; | X | |
dwSpeakerGain; | X | |
dwHeadsetHookSwitchMode; | X | |
dwHeadsetVolume; | X | |
dwHeadsetGain; | X | |
dwDisplaySize; | X | |
dwDisplayOffset; | X | |
dwKeeperModesSize; | X | |
dwKeeperModesOffset; | X | |
dwOwnerNameSize; | X | |
dwOwnerNameOffset; | X | |
dwDevSpecificSize; | X | |
dwDevSpecificOffset; | X |
TAPI può usare questa funzione per determinare lo stato corrente di un dispositivo telefonico aperto. Le informazioni sullo stato descrivono le informazioni sui dispositivi hookswitch del dispositivo telefono, ringer, volume, display e lampade del telefono aperto.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | tspi.h |