Funzione lineGetDevCaps (tapi.h)

Articolo
03/08/2023

La funzione lineGetDevCaps esegue una query su un dispositivo linea specificato per determinare le funzionalità di telefonia. Le informazioni restituite sono valide per tutti gli indirizzi nel dispositivo line.

Sintassi

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo di riga 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 in ordine basso contiene il numero di versione secondaria. Questo numero viene ottenuto da lineNegotiateAPIVersion.

dwExtVersion

Numero di versione delle estensioni specifiche del provider di servizi da usare. Questo numero viene ottenuto da lineNegotiateExtVersion. 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 in ordine basso contiene il numero di versione secondaria.

lpLineDevCaps

Puntatore a una struttura di dimensioni variabili di tipo LINEDEVCAPS. Al termine della richiesta, questa struttura viene compilata con informazioni sulle funzionalità del dispositivo line. Prima di chiamare lineGetDevCaps, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

Nota Se i parametri di dimensione nella struttura non sono corretti, è possibile che i dati vengano sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento relativo all'allocazione della memoria .

Valore restituito

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

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Commenti

Prima di usare lineGetDevCaps, l'applicazione deve negoziare il numero di versione dell'API da usare e, se necessario, la versione dell'estensione da usare.

I numeri di versione dell'API e dell'estensione sono quelli con cui TAPI e il provider di servizi devono operare. Se gli intervalli di versioni non si sovrappongono, l'applicazione, l'API o le versioni del provider di servizi non sono compatibili e viene restituito un errore.

Uno dei membri della struttura LINEDEVCAPS restituito da questa funzione contiene il numero di indirizzi assegnati al dispositivo di riga specificato. Gli identificatori di indirizzo effettivi usati per fare riferimento a singoli indirizzi variano da zero a uno minore del numero restituito. Le funzionalità di ogni indirizzo possono essere diverse. Usare lineGetAddressCaps per ogni combinazione dwDeviceID, dwAddressID> disponibile < per determinare le funzionalità esatte di ogni indirizzo. Si noti che un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.