funzione TSPI_lineOpen (tspi.h)

Articolo
08/26/2023

La funzione TSPI_lineOpen apre il dispositivo linea il cui identificatore del dispositivo viene specificato, restituendo l'handle del provider di servizi per il dispositivo. Il provider di servizi deve mantenere l'handle TAPI per il dispositivo da usare nelle chiamate successive alla procedura di callback LINEEVENT .

Sintassi

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Parametri

dwDeviceID

Identifica il dispositivo linea da aprire.

htLine

Handle TAPI per il dispositivo line da usare nelle chiamate successive alla procedura di callback LINEEVENT per identificare il dispositivo.

lphdLine

Puntatore a un HDRVLINE in cui il provider di servizi riempie il relativo handle per il dispositivo line.

dwTSPIVersion

Versione TSPI.

lpfnEventProc

Puntatore alla routine di callback LINEEVENT fornita da TAPI che il provider di servizi chiama per segnalare gli eventi successivi nella riga.

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_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Commenti

Il provider di servizi deve riservare tutte le risorse non condivisibili necessarie per gestire la riga. Tuttavia, tutte le azioni che possono essere posticipate a lineMakeCall devono essere. Si tratta di un presupposto di progettazione in TAPI che lineOpen è un'operazione "economica". Ad esempio, se la riga viene aperta solo in modalità di monitoraggio, non deve essere necessario che un provider di servizi basato su porta COMM apra la porta COMM.

Questa procedura non corrisponde direttamente ad alcuna procedura a livello TAPI, in cui le funzioni di abilitazione delle estensioni specifiche del dispositivo, la selezione delle caratteristiche della linea e l'impostazione del rilevamento del tipo di supporto sono incluse nella funzionalità definita da lineOpen. A livello di TSPI, queste funzionalità aggiuntive vengono separate in TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection e TSPI_lineConditionalMediaDetection.