Struttura PHONECAPS (tapi.h)

Articolo
03/05/2024

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.