funzione lineDevSpecific (tapi.h)

Articolo
08/26/2023

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

Sintassi

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Parametri

hLine

Gestire in un dispositivo linea. Questo parametro è obbligatorio.

dwAddressID

Identificatore di indirizzo nel dispositivo della riga specificata. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

hCall

Gestire una chiamata. Questo parametro è facoltativo, ma se è specificato, la chiamata che rappresenta deve appartenere al dispositivo della linea hLine . Lo stato della chiamata di hCall è specifico del dispositivo.

lpParams

Puntatore a un'area di memoria usata per contenere un blocco di parametri. 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 dell'area del blocco dei parametri, 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 oppure è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

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 un profilo di parametro generico. L'interpretazione della struttura dei parametri è specifica del dispositivo. Se dwAddressID e/o hCall devono essere validi è specifico del dispositivo. Se specificato, devono appartenere a hLine. Le indicazioni e le risposte inviate di nuovo all'applicazione specifica del dispositivo devono usare il messaggio di LINE_DEVSPECIFIC .

Un provider di servizi può fornire l'accesso alle funzioni specifiche del dispositivo definendo i parametri da usare con questa funzione. Le applicazioni che vogliono usare queste estensioni specifiche del dispositivo devono consultare la documentazione specifica del dispositivo (in questo caso, specifica del fornitore) che descrive quali estensioni sono definite. In genere, un'applicazione che si basa su queste estensioni specifiche del dispositivo non è in grado di usare altri ambienti del provider di servizi.

Attenzione TAPI scriverà i dati restituiti nel buffer a cui fa riferimento lParam quando viene restituito il messaggio di LINE_REPLY. Ciò significa che il buffer deve rimanere valido finché non viene restituito il messaggio LINE_REPLY; in caso contrario, il danneggiamento dei dati e le eccezioni possono verificarsi.