Struttura PHONESTATUS (tapi.h)

Articolo
03/05/2024

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.