Struttura PHONECAPS (tapi.h)
La struttura PHONECAPS descrive le funzionalità di un dispositivo telefonico. Le funzioni phoneGetDevCaps e TSPI_phoneGetDevCaps restituiscono questa struttura.
Sintassi
typedef struct phonecaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwProviderInfoSize;
DWORD dwProviderInfoOffset;
DWORD dwPhoneInfoSize;
DWORD dwPhoneInfoOffset;
DWORD dwPermanentPhoneID;
DWORD dwPhoneNameSize;
DWORD dwPhoneNameOffset;
DWORD dwStringFormat;
DWORD dwPhoneStates;
DWORD dwHookSwitchDevs;
DWORD dwHandsetHookSwitchModes;
DWORD dwSpeakerHookSwitchModes;
DWORD dwHeadsetHookSwitchModes;
DWORD dwVolumeFlags;
DWORD dwGainFlags;
DWORD dwDisplayNumRows;
DWORD dwDisplayNumColumns;
DWORD dwNumRingModes;
DWORD dwNumButtonLamps;
DWORD dwButtonModesSize;
DWORD dwButtonModesOffset;
DWORD dwButtonFunctionsSize;
DWORD dwButtonFunctionsOffset;
DWORD dwLampModesSize;
DWORD dwLampModesOffset;
DWORD dwNumSetData;
DWORD dwSetDataSize;
DWORD dwSetDataOffset;
DWORD dwNumGetData;
DWORD dwGetDataSize;
DWORD dwGetDataOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwDeviceClassesSize;
DWORD dwDeviceClassesOffset;
DWORD dwPhoneFeatures;
DWORD dwSettableHandsetHookSwitchModes;
DWORD dwSettableSpeakerHookSwitchModes;
DWORD dwSettableHeadsetHookSwitchModes;
DWORD dwMonitoredHandsetHookSwitchModes;
DWORD dwMonitoredSpeakerHookSwitchModes;
DWORD dwMonitoredHeadsetHookSwitchModes;
GUID PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;
Members
dwTotalSize
Dimensioni totali allocate 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.
dwProviderInfoSize
Dimensioni in byte delle informazioni specifiche del provider. Se le informazioni specifiche del provider sono un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null .
dwProviderInfoOffset
Offset dall'inizio della struttura al campo di dimensioni variabile contenente informazioni specifiche del provider di servizi.
Questo membro fornisce informazioni sull'hardware e/o sul software del provider, ad esempio il nome del fornitore e i numeri di versione dell'hardware e del software. Queste informazioni possono essere utili quando un utente deve chiamare il servizio clienti con problemi relativi al provider. Le dimensioni del campo sono specificate da dwProviderInfoSize.
dwPhoneInfoSize
Dimensioni delle informazioni specifiche del telefono, in byte. Se le informazioni specifiche del telefono sono un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null .
dwPhoneInfoOffset
Offset dall'inizio della struttura al campo dispositivo di dimensioni variabile contenente informazioni specifiche del telefono.
Questo membro fornisce informazioni sul dispositivo telefonico collegato, ad esempio il produttore del dispositivo telefonico, il nome del modello, la versione del software e così via. Queste informazioni possono essere utili quando un utente deve chiamare il servizio clienti con problemi relativi al telefono. Le dimensioni del campo sono specificate da dwPhoneInfoSize.
dwPermanentPhoneID
Identificatore permanente in base al quale il dispositivo telefonico è noto nella configurazione del sistema.
dwPhoneNameSize
Dimensioni del nome configurabile per il telefono, incluso il carattere di terminazione Null , in byte.
dwPhoneNameOffset
Offset dall'inizio della struttura al campo dispositivo di dimensioni variabile contenente un nome configurabile dall'utente per questo dispositivo telefonico. Questo nome può essere configurato dall'utente durante la configurazione del provider di servizi del dispositivo telefonico e viene fornito per comodità dell'utente. Le dimensioni del campo sono specificate da dwPhoneNameSize.
dwStringFormat
Formato stringa da usare con questo dispositivo telefonico. Questo membro usa una delle costanti STRINGFORMAT_.
dwPhoneStates
Modifiche dello stato per questo dispositivo telefonico per cui l'applicazione può ricevere una notifica in un messaggio di PHONE_STATE . Membro uno o più costanti PHONESTATE_.
dwHookSwitchDevs
Dispositivi hookswitch del telefono. Questo membro usa una delle costanti PHONEHOOKSWITCHDEV_.
dwHandsetHookSwitchModes
Modalità hookswitch del ricevitore. Il membro è significativo solo se il dispositivo hookswitch è elencato in dwHookSwitchDevs. Usa una delle costanti PHONEHOOKSWITCHMODE_.
dwSpeakerHookSwitchModes
Modalità hookswitch dell'altoparlante. Il membro è significativo solo se il dispositivo hookswitch è elencato in dwHookSwitchDevs. Usa una delle costanti PHONEHOOKSWITCHMODE_.
dwHeadsetHookSwitchModes
Modalità Hookswitch del visore VR. Il membro è significativo solo se il dispositivo hookswitch è elencato in dwHookSwitchDevs. Usa una delle costanti PHONEHOOKSWITCHMODE_.
dwVolumeFlags
Funzionalità di impostazione del volume dei componenti dell'altoparlante del dispositivo telefono. Se il bit nella posizione PHONEHOOKSWITCHDEV_ è TRUE, il volume del componente altoparlante del dispositivo hookswitch corrispondente può essere regolato con phoneSetVolume.
dwGainFlags
Funzionalità di impostazione dei componenti del microfono del dispositivo telefono. Se la posizione di bit PHONEHOOKSWITCHDEV_ è TRUE, il volume del componente microfono del dispositivo hookswitch corrispondente può essere regolato con phoneSetGain.
dwDisplayNumRows
Visualizzare le funzionalità del dispositivo telefonico descrivendo il numero di righe nella visualizzazione del telefono. I membri dwDisplayNumRows e dwDisplayNumColumns sono entrambi zero per un dispositivo telefonico senza uno schermo.
dwDisplayNumColumns
Visualizzare le funzionalità del dispositivo telefonico descrivendo il numero di colonne nella visualizzazione del telefono. I membri dwDisplayNumRows e dwDisplayNumColumns sono entrambi zero per un dispositivo telefonico senza uno schermo.
dwNumRingModes
Funzionalità dell'anello del dispositivo telefonico. Il telefono è in grado di squillare con dwNumRingModes diversi modelli di anello, identificati come 1, 2, fino a dwNumRingModes meno uno. Se il valore di questo membro è 0, le applicazioni non hanno alcun controllo sulla modalità anello del telefono. Se il valore di questo membro è maggiore di 0, indica il numero di modalità anello oltre al silenzio supportato dal provider di servizi. Il valore 0 nel parametro lpdwRingMode di phoneGetRing o del parametro dwRingMode di phoneSetRing indica il silenzio (il telefono non suona o non deve essere generato) e i valori dwRingMode da 1 a dwNumRingModes sono modalità circolari valide per il dispositivo telefonico.
dwNumButtonLamps
Numero di lampade/pulsanti sul dispositivo telefonico rilevabili in TAPI. I pulsanti e le lampade sono identificati dal relativo identificatore. Gli identificatori di pulsante/lampada validi vanno da zero a dwNumButtonPartizioni meno uno. Ai pulsanti del tastierino "0", fino a "9", "*" e "#" vengono assegnati gli identificatori da 0 a 12.
dwButtonModesSize
Dimensione della matrice delle modalità pulsante, in byte.
dwButtonModesOffset
Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le modalità pulsante dei pulsanti del telefono. La matrice viene indicizzata in base all'identificatore pulsante/lampada. Questa matrice usa le costanti PHONEBUTTONMODE_. Le dimensioni della matrice sono specificate da dwButtonModesSize.
dwButtonFunctionsSize
Dimensioni del campo delle funzioni del pulsante, in byte.
dwButtonFunctionsOffset
Sfalsare dall'inizio di questa struttura al campo di dimensioni variabili contenente le funzioni del pulsante dei pulsanti del telefono. La matrice viene indicizzata in base all'identificatore pulsante/lampada. Questa matrice usa le costanti PHONEBUTTONFUNCTION_. Le dimensioni della matrice sono specificate da dwButtonFunctionsSize.
dwLampModesSize
Dimensione della matrice di modalità lampada, in byte.
dwLampModesOffset
Sfalsare dall'inizio di questa struttura al campo di dimensioni variabile contenente le modalità della lampada delle lampade del telefono. La matrice viene indicizzata in base all'identificatore pulsante/lampada. Questa matrice usa le costanti PHONELAMPMODE_. Le dimensioni della matrice sono specificate da dwPyModesSize.
dwNumSetData
Numero di aree di download diverse nel dispositivo telefonico. Le diverse aree vengono definite usando gli ID dati 0, 1, , dwNumSetData meno uno. Se questo membro è zero, il telefono non supporta la funzionalità di download.
dwSetDataSize
Dimensioni della matrice di dimensioni dei dati, in byte.
dwSetDataOffset
Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le dimensioni (in byte) delle aree dati di download del telefono. Si tratta di una matrice con elementi di dimensioni DWORD indicizzati dall'identificatore di dati. Le dimensioni della matrice sono specificate da dwSetDataSize.
dwNumGetData
Numero di aree di caricamento diverse nel dispositivo telefonico. Le diverse aree vengono definite usando gli ID dati 0, 1, , dwNumGetData meno uno. Se questo campo è zero, il telefono non supporta la funzionalità di caricamento.
dwGetDataSize
Dimensioni della matrice di dimensioni dei dati, in byte.
dwGetDataOffset
Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le dimensioni (in byte) delle aree dati di caricamento del telefono. Si tratta di una matrice con elementi di dimensioni DWORD indicizzati dall'identificatore di dati. Le dimensioni della matrice sono specificate da dwGetDataSize.
dwDevSpecificSize
Dimensioni del campo specifico del dispositivo, in byte. Se le informazioni specifiche del dispositivo sono un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null .
dwDevSpecificOffset
Offset dall'inizio di questa struttura al campo specifico del dispositivo di dimensioni variabili. Le dimensioni del campo vengono specificate da dwDevSpecificSize.
dwDeviceClassesSize
Dimensioni degli identificatori di classe di dispositivo supportati, in byte.
dwDeviceClassesOffset
Offset dall'inizio di questa struttura a una stringa costituita dagli identificatori della classe di dispositivo supportati nel dispositivo per l'uso con phoneGetID. Gli identificatori sono separati da NULLs e l'ultimo identificatore nell'elenco è seguito da due valori NULL. Le dimensioni del campo sono specificate da dwDeviceClassesSize.
dwPhoneFeatures
Flag che indicano le funzioni api di telefonia che possono essere richiamate sul telefono. Uno zero indica che la funzionalità corrispondente non è implementata e non può mai essere richiamata dall'applicazione sul telefono; uno indica che la funzionalità può essere richiamata a seconda dello stato del dispositivo e di altri fattori. Questo membro usa costanti PHONEFEATURE_.
dwSettableHandsetHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere impostati sul portatile usando phoneSetHookSwitch.
dwSettableSpeakerHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere impostati sull'altoparlante usando phoneSetHookSwitch.
dwSettableHeadsetHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere impostati sul visore VR usando phoneSetHookSwitch.
dwMonitoredHandsetHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere rilevati e segnalati per il ricevitore in un messaggio di PHONE_STATE e tramite phoneGetHookSwitch.
dwMonitoredSpeakerHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere rilevati e segnalati per l'altoparlante in un messaggio PHONE_STATE e da phoneSetHookSwitch.
dwMonitoredHeadsetHookSwitchModes
PHONEHOOKSWITCHMODE_ valori che possono essere rilevati e segnalati per il visore VR in un messaggio PHONE_STATE e da phoneSetHookSwitch.
PermanentPhoneGuid
GUID associato in modo permanente a questo telefono.
Commenti
Le estensioni specifiche del dispositivo devono usare l'area di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.
I membri dwDeviceClassesSize tramite dwMonitoredHeadsetHookSwitchModes sono disponibili solo per le applicazioni che aprono il dispositivo telefonico con una versione API 2.0 o successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |