funzione TSPI_phoneGetDevCaps (tspi.h)
La funzione TSPI_phoneGetDevCaps esegue una query su un dispositivo telefonico specificato per determinare le funzionalità di telefonia.
Sintassi
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
Parametri
dwDeviceID
Dispositivo telefonico da eseguire query.
dwTSPIVersion
Numero di versione TSPI negoziata. Questo valore viene negoziato per questo dispositivo tramite la funzione TSPI_phoneNegotiateTSPIVersion .
dwExtVersion
Numero di versione dell'estensione negoziata. Questo valore viene negoziato per questo dispositivo tramite la funzione TSPI_phoneNegotiateExtVersion .
lpPhoneCaps
Puntatore alla memoria in cui il provider di servizi scrive una struttura variabile di tipo PHONECAPS. Al termine della richiesta, questa struttura viene riempita con informazioni sulla funzionalità del dispositivo telefonico. Prima di chiamare TSPI_phoneGetDevCaps, l'applicazione imposta il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.
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_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Commenti
Il provider di servizi compila tutti i membri della struttura di dati PHONEBUTTONINFO , ad eccezione di dwTotalSize, che viene compilato da TAPI. Il provider di servizi non deve sovrascrivere il membro dwTotalSize .
Se dwExtVersion è zero, non vengono richieste informazioni sull'estensione. Se è diverso da zero, contiene un valore che è già stato negoziato per questo dispositivo con la funzione TSPI_phoneNegotiateExtVersion . Il provider di servizi compila informazioni estese specifiche del dispositivo e del fornitore in base alla versione dell'estensione specificata.
Dopo che il provider di servizi restituisce dalla funzione TSPI_phoneGetDevCaps , TAPI imposta il membro dwPhoneStates della struttura PHONECAPS come indicato di seguito:
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |