funzione lineDevSpecificFeature (tapi.h)

Articolo
08/26/2023

La funzione lineDevSpecificFeature consente ai provider di servizi di fornire l'accesso alle funzionalità non offerte da altre funzioni TAPI. Il significato di queste estensioni è specifico del dispositivo e sfrutta queste estensioni richiede che l'applicazione sia completamente consapevole di loro.

Sintassi

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

Parametri

hLine

Gestire il dispositivo linea.

dwFeature

Funzionalità da richiamare sul dispositivo di riga. Questo parametro usa le costanti PHONEBUTTONFUNCTION_.

lpParams

Puntatore a un'area di memoria usata per contenere un blocco di parametri dipendente dalla funzionalità. Il formato di questo blocco di parametri è specifico del dispositivo e il relativo contenuto viene passato da TAPI a o dal provider di servizi.

dwSize

Dimensioni del buffer, in byte.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

I valori restituiti aggiuntivi sono specifici del dispositivo.

Commenti

Questa operazione fa parte dei servizi di telefonia estesa. Fornisce l'accesso a una funzionalità specifica del dispositivo senza definirne il significato. Questa operazione è disponibile solo se l'applicazione ha negoziato correttamente una versione di estensione specifica del dispositivo.

Questa funzione fornisce all'applicazione le funzionalità di emulazione del pulsante di funzionalità del telefono. Quando un'applicazione richiama questa operazione, specifica l'equivalente di un evento di pressione del pulsante. Questo metodo di richiamo delle funzionalità è dipendente dal dispositivo, perché TAPI non definisce il loro significato. In genere, un'applicazione che si basa su queste estensioni specifiche del dispositivo non funziona con altri ambienti del provider di servizi.

La struttura puntata da lpParams non deve contenere puntatori perché non sarebbe stata tradotta correttamente (thunked) quando si esegue un'applicazione a 16 bit in una versione a 32 bit di TAPI e viceversa.