Struttura PHONEBUTTONINFO (tapi.h)

Articolo
03/02/2024

La struttura PHONEBUTTONINFO contiene informazioni su un pulsante in un dispositivo telefonico. Questa struttura viene usata da più funzioni TAPI e TSPI.

Sintassi

typedef struct phonebuttoninfo_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwButtonMode;
  DWORD dwButtonFunction;
  DWORD dwButtonTextSize;
  DWORD dwButtonTextOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwButtonState;
} PHONEBUTTONINFO, *LPPHONEBUTTONINFO;

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.

dwButtonMode

Modalità o classe di utilizzo generale del pulsante. Questo membro usa una delle costanti PHONEBUTTONMODE_.

dwButtonFunction

Funzione assegnata al pulsante. Questo membro utilizza una delle costanti PHONEBUTTONFUNCTION_.

dwButtonTextSize

Dimensioni del testo descrittivo per il pulsante, in byte.

dwButtonTextOffset

Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente testo descrittivo per questo pulsante. Il formato di queste informazioni è specificato nel membro dwStringFormat delle funzionalità del dispositivo del telefono. Le dimensioni del campo sono specificate da dwButtonTextSize.

dwDevSpecificSize

Dimensioni del campo specifico del dispositivo, in byte. Se il campo specifico del dispositivo è un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null .

dwDevSpecificOffset

Offset dall'inizio della struttura al campo specifico del dispositivo di dimensioni variabili. Le dimensioni del campo vengono specificate da dwDevSpecificSize.

dwButtonState

Per la funzione phoneGetButtonInfo , questo campo indica lo stato corrente del pulsante, usando le costanti PHONEBUTTONSTATE_. Questo campo viene ignorato dalla funzione phoneSetButtonInfo .

Commenti

Le estensioni specifiche del dispositivo devono usare l'area di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.

Le applicazioni meno recenti vengono compilate senza questo campo nella struttura PHONEBUTTONINFO e usano sizeOF PHONEBUTTONINFO più piccolo delle nuove dimensioni. L'applicazione passa un parametro dwAPIVersion con la funzione phoneOpen , che può essere usata per indicazioni da TAPI nella gestione di questa situazione. Se l'applicazione passa un valore dwTotalSize minore della dimensione della parte fissa della struttura, come definito nella dwAPIVersion specificata, viene restituito PHONEERR_STRUCTURETOOSMALL. Se è stata allocata memoria sufficiente dall'applicazione, prima di chiamare la funzione TSPI_phoneGetButtonInfo , TAPI imposta i membri dwNeededSize e dwUsedSize alle dimensioni fisse della struttura come esiste nella versione dell'API specificata.

I nuovi provider di servizi (che supportano la nuova versione dell'API) devono esaminare la versione dell'API passata. Se la versione dell'API è inferiore alla versione più recente supportata dal provider, il provider di servizi non deve compilare campi non supportati nelle versioni precedenti dell'API, perché queste rientrano nella parte variabile della struttura precedente.

Le nuove applicazioni devono essere riconosciute della versione dell'API negoziata e non esaminare il contenuto dei campi nella parte fissa oltre la fine originale della parte fissa della struttura per la versione dell'API negoziata.