funzione phoneGetDevCapsA (tapi.h)

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

Sintassi

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

Parametri

hPhoneApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo telefonico su cui eseguire una query.

dwAPIVersion

Numero di versione dell'API di telefonia da usare. La parola di ordine elevato contiene il numero di versione principale; La parola con ordine basso contiene il numero di versione secondario. Questo numero viene ottenuto con la funzione phoneNegotiateAPIVersion.

dwExtVersion

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

lpPhoneCaps

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

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I possibili valori restituiti 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.

Osservazioni

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 di estensione sono quelli con 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.

Nota

L'intestazione tapi.h definisce phoneGetDevCaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

PHONECAPS

funzioni supplementari del servizio telefonico

panoramica dei riferimenti TAPI 2.2

phoneNegotiateAPIVersion

phoneNegotiateExtVersion