Funzione lineSetDevConfig (tapi.h)

Articolo
03/08/2023

La funzione lineSetDevConfig consente all'applicazione di ripristinare la configurazione di un dispositivo di flusso multimediale in un dispositivo line in un'installazione ottenuta in precedenza usando lineGetDevConfig. Ad esempio, il contenuto di questa struttura può specificare velocità dei dati, formato carattere, schemi di modularità e impostazioni del protocollo di controllo degli errori per un dispositivo multimediale "datamodem" associato alla riga.

Sintassi

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

Parametri

dwDeviceID

Identificatore del dispositivo linea da configurare.

lpDeviceConfig

Puntatore alla struttura di dati di configurazione opaca restituita da lineGetDevConfig nella parte variabile della struttura VARSTRING .

dwSize

Numero di byte nella struttura a cui punta lpDeviceConfig. Questo valore viene restituito nel membro dwStringSize nella struttura VARSTRING restituito da lineGetDevConfig.

lpszDeviceClass

Puntatore a una stringa con terminazione Null che specifica la classe di dispositivo del dispositivo la cui configurazione deve essere impostata. Le stringhe di classe del dispositivo valide corrispondono a quelle specificate per la funzione lineGetID .

Valore restituito

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

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

Commenti

Gli stati di chiamata sono specifici del dispositivo.

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 in un altro database associato a una destinazione di chiamata specifica. Quando l'utente vuole chiamare di nuovo la stessa destinazione, questa funzione lineSetDevConfig può essere usata per ripristinare le impostazioni di configurazione selezionate dall'utente. È possibile usare le funzioni lineSetDevConfig, lineConfigDialog e lineGetDevConfig per consentire all'utente di visualizzare e aggiornare le impostazioni.

Il formato esatto dei dati contenuti all'interno della struttura è specifico per l'API flusso multimediale e lineare (classe dispositivo), non è documentata e non è definita. L'applicazione deve considerarla "opaca" e non manipolare direttamente il contenuto. In genere, la struttura può essere inviata usando questa funzione solo allo stesso dispositivo da cui è stato ottenuto. Alcuni provider di servizi di telefonia possono tuttavia consentire l'interscambio di strutture tra dispositivi identici (ovvero più porte sulla stessa scheda modem multiport). Tale interscambio non è garantito in alcun modo, anche per i dispositivi della stessa classe di dispositivi.

Alcuni provider di servizi possono consentire l'impostazione della configurazione mentre una chiamata è attiva e altri potrebbero non essere impostati.