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

Vedi anche

LINEADDRESSCAPS

TSPI_providerInit