funzione phoneGetDevCaps (tapi.h)

Articolo
08/26/2023

La funzione phoneGetDevCaps esegue una query su un dispositivo telefonico specificato per determinare le funzionalità di telefonia.

Sintassi

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parametri

hPhoneApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo telefonico da eseguire query.

dwAPIVersion

Numero di versione dell'API Telefonia da usare. La parola ad ordine elevato contiene il numero di versione principale; la parola a basso ordine contiene il numero di versione secondaria. Questo numero viene ottenuto con il telefono della funzioneNegotiateAPIVersion.

dwExtVersion

Numero di versione delle estensioni specifiche del provider di servizi da usare. Questo numero viene ottenuto con il telefono della funzioneNegotiateExtVersion. Può essere lasciato zero se non devono essere usate estensioni specifiche del dispositivo. In caso contrario, la parola ad ordine elevato contiene il numero di versione principale; la parola a basso ordine contiene il numero di versione secondaria.

lpPhoneCaps

Puntatore a una struttura di dimensioni variabile di tipo PHONECAPS. Al termine della richiesta, questa struttura viene riempita con le informazioni sulle funzionalità del dispositivo telefonico.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Commenti

Prima di usare phoneGetDevCaps, l'applicazione deve negoziare il numero di versione TAPI da usare (vedere phoneNegotiateAPIVersion) e, facoltativamente, la versione dell'estensione da usare (vedere phoneNegotiateExtVersion).

I numeri di versione TAPI e estensione sono quelli in cui è necessario operare TAPI, DLL di telefonia e provider di servizi. Se gli intervalli di versioni non si sovrappongono, le versioni dell'applicazione e dell'API o del provider di servizi non sono compatibili e viene restituito un errore.