funzione TSPI_lineDevSpecific (tspi.h)

La funzione TSPI_lineDevSpecific viene usata come meccanismo di estensione generale per consentire ai provider di servizi di fornire l'accesso alle funzionalità non descritte in altre operazioni. I significati delle estensioni sono specifici del dispositivo e per sfruttare queste estensioni l'applicazione deve essere completamente consapevole.

Sintassi

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdLine

L'handle del provider di servizi sulla riga da gestire.

dwAddressID

Indirizzo sulla riga specificata da gestire. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

hdCall

L'handle del provider di servizi per la chiamata da gestire. Questo campo può avere il valore NULL. Lo stato della chiamata di hdCall è specifico del dispositivo.

lpParams

Puntatore a un'area di memoria usata per contenere un blocco di parametri. Il formato di questo blocco di parametri è specifico del dispositivo.

dwSize

Dimensioni in byte dell'area del blocco dei parametri. Se il parametro lpParams è un puntatore a una stringa, le dimensioni devono includere il terminatore Null .

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è 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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Commenti

I valori restituiti aggiuntivi sono specifici del dispositivo.

Questa operazione fornisce un profilo di parametro generico. L'interpretazione della struttura dei parametri è specifica del dispositivo. TAPI specifica sempre il parametro hdLine . Se dwAddressID e/o hdCall devono essere validi è specifico del dispositivo. Se specificato, devono appartenere a hdLine. Indicazioni e risposte inviate all'applicazione che sono specifiche del dispositivo usano il messaggio di LINE_DEVSPECIFIC .

Questa funzione viene chiamata in risposta diretta a un'applicazione che chiama la funzione TAPI lineDevSpecific. TAPI converte i parametri hLine e hdCall usati a livello TAPI ai parametri hdLine e hdCall corrispondenti usati a livello TSPI. Il buffer lpParams viene passato non modificato.

Nota La struttura dei dati lpParams non deve contenere puntatori perché non verrebbe tradotta correttamente (thunked) quando si esegue un'applicazione a 16 bit in una versione a 32 bit di TAPI e viceversa.

 

Un provider di servizi può fornire l'accesso alle funzioni specifiche del dispositivo definendo i parametri da usare con questa operazione. Le applicazioni che vogliono usare queste estensioni specifiche del dispositivo devono consultare la documentazione specifica del dispositivo (in questo caso significa specifica del fornitore) che descrive quali estensioni sono definite.

Nota Un'applicazione che si basa su estensioni specifiche del dispositivo non è portabile in uso con altri ambienti del provider di servizi. Usare estensioni specifiche del fornitore.

 

Questa operazione fa parte dei servizi di telefonia estesa. Fornisce solo l'accesso a una funzionalità specifica del dispositivo senza definirne il significato. Questa operazione è disponibile solo se l'applicazione ha negoziato correttamente e selezionato una versione di estensione specifica del dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion