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

Vedi anche

PHONESTATUS

PHONE_STATE