Funzione lineGetDevCapsA (tapi.h)

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 lineGetDevCapsA(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo linea 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 lineNegotiateAPIVersion.

dwExtVersion

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

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 allocazione di memoria.

 

Valore restituito

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

Osservazioni

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 nella struttura LINEDEVCAPS restituita da questa funzione contiene il numero di indirizzi assegnati al dispositivo linea 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 <dwDeviceID, dwAddressID> combinazione 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.

Nota

L'intestazione tapi.h definisce lineGetDevCaps 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

di riferimento dei servizi di telefonia di base

LINEDEVCAPS

panoramica dei riferimenti TAPI 2.2

lineGetAddressCaps

rigaNegotiateAPIVersion

lineNegotiateExtVersion