Struttura PHONESTATUS (tapi.h)
La struttura PHONESTATUS descrive lo stato corrente di un dispositivo telefonico. Le funzioni phoneGetStatus e TSPI_phoneGetStatus restituiscono questa struttura.
Sintassi
typedef struct phonestatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwStatusFlags;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwRingMode;
DWORD dwRingVolume;
DWORD dwHandsetHookSwitchMode;
DWORD dwHandsetVolume;
DWORD dwHandsetGain;
DWORD dwSpeakerHookSwitchMode;
DWORD dwSpeakerVolume;
DWORD dwSpeakerGain;
DWORD dwHeadsetHookSwitchMode;
DWORD dwHeadsetVolume;
DWORD dwHeadsetGain;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwLampModesSize;
DWORD dwLampModesOffset;
DWORD dwOwnerNameSize;
DWORD dwOwnerNameOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;
Members
dwTotalSize
Dimensioni totali assegnate a questa struttura di dati, in byte.
dwNeededSize
Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.
dwUsedSize
Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.
dwStatusFlags
Flag di stato per questo dispositivo telefonico. Questo membro usa una delle costanti PHONESTATUSFLAGS_.
dwNumOwners
Numero di moduli applicazione con privilegi di proprietario per il telefono.
dwNumMonitors
Numero di moduli applicazione con privilegi di monitoraggio per il telefono.
dwRingMode
Modalità di anello corrente di un dispositivo telefonico.
dwRingVolume
Volume dell'anello corrente di un dispositivo telefonico. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (volume massimo).
dwHandsetHookSwitchMode
Modalità di hookswitch corrente dell'handset del telefono. Questo membro usa una delle costanti PHONEHOOKSWITCHMODE_.
dwHandsetVolume
Volume dell'altoparlante corrente del dispositivo del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (volume massimo).
dwHandsetGain
Guadagno del microfono corrente del dispositivo del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (guadagno massimo).
dwSpeakerHookSwitchMode
Modalità di hookswitch corrente dell'altoparlante del telefono. Questo membro usa una delle costanti PHONEHOOKSWITCHMODE_.
dwSpeakerVolume
Volume dell'altoparlante corrente del dispositivo altoparlante del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (volume massimo).
dwSpeakerGain
Guadagno del microfono corrente del dispositivo altoparlante del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (guadagno massimo).
dwHeadsetHookSwitchMode
Modalità di hookswitch corrente del visore del telefono. Questo membro usa una delle costanti PHONEHOOKSWITCHMODE_.
dwHeadsetVolume
Volume dell'altoparlante corrente del dispositivo visore del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (volume massimo).
dwHeadsetGain
Guadagno del microfono corrente del dispositivo visore del telefono. Si tratta di un valore tra 0x00000000 (silenzio) e 0x0000FFFF (guadagno massimo).
dwDisplaySize
Dimensioni delle informazioni di visualizzazione, in byte.
dwDisplayOffset
Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le informazioni di visualizzazione correnti del telefono. Le dimensioni del campo sono specificate da dwDisplaySize.
dwLampModesSize
Dimensioni della matrice delle modalità della lampada corrente, in byte.
dwLampModesOffset
Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le modalità correnti della lampada del telefono. Le dimensioni del campo sono specificate da dwLampModesSize.
dwOwnerNameSize
Dimensioni del nome del proprietario corrente, incluso il terminatore Null , in byte.
dwOwnerNameOffset
Offset dall'inizio della struttura al campo di dimensioni variabile contenente il nome dell'applicazione che è il proprietario corrente del dispositivo telefonico. Il nome è il nome dell'applicazione fornito dall'applicazione quando viene richiamato con phoneInitialize o phoneInitializeEx. Se non è stato specificato alcun nome applicazione, viene invece usato il nome file dell'applicazione. Le dimensioni del campo sono specificate da dwOwnerNameSize. Se il telefono attualmente non ha alcun proprietario, dwOwnerNameSize è zero.
dwDevSpecificSize
Dimensioni del campo specifico del dispositivo, in byte. Se le informazioni specifiche del dispositivo sono un puntatore a una stringa, le dimensioni devono includere il terminatore Null .
dwDevSpecificOffset
Offset dall'inizio di questa struttura al campo specifico del dispositivo di dimensioni variabile. La dimensione del campo è specificata da dwDevSpecificSize.
dwPhoneFeatures
Flag che indicano quali funzioni API di telefonia possono essere richiamate nel telefono, considerando la disponibilità della funzionalità nelle funzionalità del dispositivo, lo stato corrente del dispositivo e la proprietà del dispositivo dell'applicazione di chiamata. Zero indica che la funzionalità corrispondente non può essere richiamata dall'applicazione nel telefono nello stato corrente; una indica che la funzionalità può essere richiamata. Questo membro usa una o più costanti PHONEFEATURE_.
Commenti
Le estensioni specifiche del dispositivo devono usare l'area devSpecific (dwDevSpecificSize e dwDevSpecificOffset) variamente ridimensionata di questa struttura di dati.
Il membro dwPhoneFeatures è disponibile solo per le applicazioni che aprono il dispositivo telefonico con una versione API di 2.0 o versione successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |