Funzione lineSetDevConfigA (tapi.h)

La funzione lineSetDevConfig consente all'applicazione di ripristinare la configurazione di un dispositivo di flusso multimediale in un dispositivo line in un dispositivo line ottenuto 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 linea.

Sintassi

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

Parametri

dwDeviceID

Identificatore del dispositivo linea da configurare.

lpDeviceConfig

Puntatore alla struttura dei 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 restituita 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 di dispositivo valide sono uguali 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 possibili valori restituiti 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.

Osservazioni

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 usarelineSetDevConfig , lineConfigDialoge le funzioni lineGetDevConfig per consentire all'utente di visualizzare e aggiornare le impostazioni.

Il formato esatto dei dati contenuti nella struttura è specifico dell'API line e media stream (classe device), 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 intercambiabilità non è garantita 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 altre potrebbero non essere impostate.

Nota

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

panoramica dei riferimenti TAPI 2.2

VARSTRING

lineConfigDialog

lineGetDevConfig

lineGetID