funzione TSPI_lineGetDevCaps (tspi.h)

La funzione TSPI_lineGetDevCaps esegue una query su un dispositivo linea specificato per determinare le funzionalità di telefonia. Le informazioni restituite sono valide per tutti gli indirizzi nel dispositivo linea.

Sintassi

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parametri

dwDeviceID

Dispositivo di riga da eseguire query.

dwTSPIVersion

Numero di versione TSPI negoziata. Questo valore è già stato negoziato per questo dispositivo tramite la funzione TSPI_lineNegotiateTSPIVersion .

dwExtVersion

Numero di versione dell'estensione negoziata. Questo valore è già stato negoziato per questo dispositivo tramite la funzione TSPI_lineNegotiateExtVersion . Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.

lpLineDevCaps

Puntatore a una struttura di dimensioni variabile di tipo LINEDEVCAPS. Al termine della richiesta, questa struttura viene riempita con le informazioni sulle funzionalità del dispositivo line.

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_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Commenti

L'identificatore del dispositivo linea per un provider di servizi è sequenziale dal valore impostato dal parametro dwLineDeviceIDBase passato alla funzione TSPI_providerInit .

Il parametro formale dwExtVersion indica il numero di versione delle informazioni sull'estensione richieste. Se è zero, non vengono richieste informazioni sull'estensione. Se è diverso da zero, contiene un valore che è stato negoziato per questo dispositivo con la funzione TSPI_lineNegotiateExtVersion . Il provider di servizi compila informazioni estese specifiche del dispositivo e del fornitore in base alla versione dell'estensione specificata.

Il provider di servizi compila tutti i membri della struttura di dati LINEDEVCAPS , ad eccezione di dwTotalSize, che viene compilato da TAPI. Il provider di servizi non deve sovrascrivere il membro dwTotalSize .

Il provider di servizi deve compilare tutti i membri della struttura di dati LINETERMCAPS o strutture incorporate nella parte variabile della struttura di dati LINEDEVCAPS .

Dopo che il provider di servizi restituisce dalla funzione TSPI_lineGetDevCaps , TAPI imposta il membro dwLinesStates della struttura LINEDEVCAPS come indicato di seguito:

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit