funzione lineDevSpecificFeature (tapi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |