funzione lineGetDevConfig (tapi.h)

Articolo
08/26/2023

La funzione lineGetDevConfig restituisce un oggetto struttura dati "opaco", il contenuto di cui sono specifici per la riga (provider di servizi) e la classe di dispositivo. L'oggetto struttura dati archivia la configurazione corrente di un dispositivo di flusso multimediale associato al dispositivo linea.

Sintassi

LONG lineGetDevConfig(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCSTR      lpszDeviceClass
);

Parametri

dwDeviceID

Identificatore del dispositivo della riga da configurare.

lpDeviceConfig

Puntatore alla posizione di memoria del tipo VARSTRING in cui viene restituita la struttura di configurazione del dispositivo. Al termine della richiesta, questa posizione viene riempita con la configurazione del dispositivo. Il membro dwStringFormat nella struttura VARSTRING è impostato su STRINGFORMAT_BINARY. Prima di chiamare lineGetDevConfig, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

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

lpszDeviceClass

Puntatore a una stringa con terminazione null che specifica la classe di dispositivo del dispositivo la cui configurazione è richiesta. Le stringhe lineGetID della classe dispositivo valide sono uguali a quelle specificate per la funzione.

Valore restituito

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

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NODEVICE.

Commenti

Gli stati di chiamata sono specifici del dispositivo.

La funzione lineGetDevConfig può essere usata per recuperare una struttura di dati da TAPI che specifica la configurazione di un dispositivo di flusso multimediale associato a un determinato dispositivo linea. Ad esempio, il contenuto di questa struttura potrebbe specificare velocità dei dati, formato carattere, schemi di modulazione e impostazioni del protocollo di controllo degli errori per un dispositivo multimediale "datamodem" associato alla riga.

In genere, un'applicazione chiama lineGetID per identificare il dispositivo di flusso multimediale associato a una riga e quindi chiama lineConfigDialog per consentire all'utente di configurare la configurazione del dispositivo. Potrebbe quindi chiamare lineGetDevConfig e salvare le informazioni di configurazione in una rubrica telefonica (o un altro database) associato a una determinata destinazione di chiamata. Quando l'utente vuole chiamare di nuovo la stessa destinazione, lineSetDevConfig può essere usato per ripristinare le impostazioni di configurazione selezionate dall'utente. Le funzioni lineSetDevConfig, lineConfigDialog e lineGetDevConfig possono essere usate, in questo modo, per consentire all'utente di visualizzare e aggiornare le impostazioni.

Il formato esatto dei dati contenuti all'interno della struttura è specifico dell'API di flusso line e multimediale (classe dispositivo), non documentata e non definita. La struttura restituita da questa funzione non può essere accessibile direttamente o modificata dall'applicazione, ma può essere archiviata solo intatta e successivamente usata in lineSetDevConfig per ripristinare le impostazioni. La struttura non può necessariamente essere passata ad altri dispositivi, anche della stessa classe di dispositivo (anche se questa può funzionare in alcune istanze, non è garantita).