funzione TSPI_phoneOpen (tspi.h)
La funzione TSPI_phoneOpen apre il dispositivo telefonico il cui identificatore del dispositivo viene specificato, restituendo l'handle opaco del provider di servizi per il dispositivo e mantenendo l'handle opaco di TAPI per il dispositivo da usare nelle chiamate successive alla procedura PHONEEVENT .
Sintassi
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Parametri
dwDeviceID
Dispositivo telefonico da aprire.
htPhone
Handle opaco TAPI per l'uso del dispositivo telefonico nelle chiamate successive alla procedura di callback PHONEEVENT per identificare il dispositivo.
lphdPhone
Puntatore a un HDRVPHONE in cui il provider di servizi scrive il relativo handle per il dispositivo telefonico da usare da TAPI nelle chiamate successive per identificare il dispositivo.
dwTSPIVersion
La versione TSPI negoziata tramite TSPI_phoneNegotiateTSPIVersion in cui può funzionare il provider di servizi.
lpfnEventProc
Puntatore alla procedura di callback PHONEEVENT fornita da TAPI che il provider di servizi chiama per segnalare gli eventi successivi sul telefono.
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:
PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.
Commenti
L'apertura di un telefono consente a TAPI di effettuare ulteriori richieste sul telefono. Il telefono diventa attivo nel senso che il provider di servizi può segnalare eventi asincroni, ad esempio le modifiche di hookswitch o la pressione del pulsante. Il provider di servizi riserva le risorse non condivisibili necessarie per gestire il telefono. Ad esempio, l'apertura di un telefono a cui si accede tramite una porta comm e un modem dovrebbe comportare l'apertura della porta comm, rendendola non più disponibile per l'uso da parte di altre applicazioni.
Se la funzione ha esito positivo, sia TAPI che il provider di servizi diventano impegnati a funzionare con il numero di versione dell'interfaccia specificato per questo dispositivo aperto. Operazioni e eventi successivi identificati usando gli handle di telefono opachi scambiati sono conformi a tale versione dell'interfaccia. Questo impegno e la validità degli handle rimangono effettivi fino a quando TAPI chiude il telefono usando TSPI_phoneClose o fino a quando il provider di servizi segnala l'evento PHONE_CLOSE. Se la funzione non ha esito positivo, non viene effettuato alcun impegno e gli handle non sono validi.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |