funzione TSPI_lineDevSpecificFeature (tspi.h)

La funzione TSPI_lineDevSpecificFeature viene usata come meccanismo di estensione per consentire ai provider di servizi di fornire l'accesso alle funzionalità non descritte in altre operazioni. I significati di queste estensioni sono specifici del dispositivo e l'uso di queste estensioni richiede tapi o l'applicazione client per essere pienamente a conoscenza di tali estensioni.

Sintassi

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdLine

Handle del provider di servizi per il dispositivo line.

dwFeature

Funzionalità da richiamare nel dispositivo line. Questo parametro usa costanti PHONEBUTTONFUNCTION_.

lpParams

Puntatore a un'area di memoria utilizzata per contenere un blocco di parametri dipendente dalla funzionalità. Il formato di questo blocco di parametri è specifico del dispositivo.

dwSize

Dimensioni del buffer in byte. Se il parametro lpParams è un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResultdell'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_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Commenti

I valori restituiti aggiuntivi sono specifici del dispositivo. Lo stato di chiamata di hdCall è specifico del dispositivo.

Questa funzione fornisce applicazioni TAPI con funzionalità di emulazione dei pulsanti di funzionalità del telefono. Quando TAPI richiama questa operazione per conto di un'applicazione client, specifica l'equivalente di un evento di pressione del pulsante. Questo metodo di richiamo delle funzionalità è estremamente dipendente dal dispositivo, perché l'API non ne definisce il significato. Quando un'applicazione si basa su estensioni specifiche del dispositivo, l'applicazione non esegue correttamente la conversione in altri ambienti del provider di servizi.

Questa funzione viene chiamata in risposta diretta a un'applicazione che chiama la funzione TAPI lineDevSpecificFeature . TAPI converte il parametro hLine usato a livello TAPI nel parametro hdLine corrispondente usato a livello TSPI. Il buffer lpParams viene passato attraverso un oggetto non modificato.

Nota La struttura di dati lpParams non deve contenere puntatori perché non vengono tradotti correttamente (con un'applicazione a 16 bit) in una versione a 32 bit di TAPI e viceversa.

 

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 TAPI ha negoziato correttamente e ha selezionato una versione dell'estensione specifica del dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

Costanti PHONEBUTTONFUNCTION_