funzione TSPI_lineGetAddressCaps (tspi.h)
La funzione TSPI_lineGetAddressCaps esegue una query sull'indirizzo specificato nel dispositivo linea specificato per determinare le funzionalità di telefonia.
Sintassi
LONG TSPIAPI TSPI_lineGetAddressCaps(
DWORD dwDeviceID,
DWORD dwAddressID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEADDRESSCAPS lpAddressCaps
);
Parametri
dwDeviceID
Dispositivo della riga contenente l'indirizzo su cui eseguire una query.
dwAddressID
Indirizzo nel dispositivo di riga specificato le cui funzionalità devono essere sottoposte a query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo. Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.
dwTSPIVersion
Numero di versione dello SPI di telefonia da utilizzare. La parola di ordine elevato contiene il numero di versione principale; la parola in ordine basso contiene il numero di versione secondaria.
dwExtVersion
Numero di versione delle estensioni specifiche del provider di servizi da usare. Questo numero è zero se non devono essere usate estensioni specifiche del dispositivo. In caso contrario, la parola di ordine elevato contiene il numero di versione principale; la parola in ordine basso contiene il numero di versione secondaria. Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.
lpAddressCaps
Puntatore a una struttura di dimensioni variabile di tipo LINEADDRESSCAPS. Al termine della richiesta, questa struttura viene compilata con informazioni sulle funzionalità degli indirizzi.
Valore restituito
Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL.
Commenti
Gli identificatori del dispositivo di riga supportati da un determinato driver vengono numerati in sequenza a partire dal valore di dwLineDeviceIDBase passato alla funzione TSPI_providerInit .
Il provider di servizi compila tutti i membri della struttura di dati LINEADDRESSCAPS , ad eccezione di dwTotalSize, compilato da TAPI. Il provider di servizi non deve sovrascrivere il membro dwTotalSize .
Dopo che il provider di servizi viene restituito dalla funzione TSPI_lineGetAddressCaps , TAPI imposta i membri dwCallInfoStates e dwCallStates della struttura LINEADDRESSCAPS come indicato di seguito:
LINEADDRESSCAPS.dwCallInfoStates |=
LINECALLINFOSTATE_NUMOWNERINCR |
LINECALLINFOSTATE_NUMOWNERDECR |
LINECALLINFOSTATE_NUMMONITORS;
LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |