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

Vedi anche

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion