Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione lineGetDevConfig restituisce un oggetto struttura di dati "opaco", il cui contenuto è specifico della riga (provider di servizi) e della classe dispositivo. L'oggetto struttura dati archivia la configurazione corrente di un dispositivo di flusso multimediale associato al dispositivo line.
Sintassi
LONG lineGetDevConfigW(
DWORD dwDeviceID,
LPVARSTRING lpDeviceConfig,
LPCWSTR lpszDeviceClass
);
Parametri
dwDeviceID
Identificatore del dispositivo linea da configurare.
lpDeviceConfig
Puntatore alla posizione di memoria di tipo VARSTRING in cui viene restituita la struttura di configurazione del dispositivo. Al termine della richiesta, questo percorso viene compilato con la configurazione del dispositivo. Il membro dwStringFormat
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.
lpszDeviceClass
Puntatore a una stringa con terminazione Null che specifica la classe di dispositivo del dispositivo la cui configurazione è richiesta. La classe di dispositivo valida stringhe lineGetID corrisponde a quelle specificate per la funzione.
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_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_UNINITIALIZED LINEERR_NODEVICE.
Osservazioni
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 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.
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 lineGetDevConfige 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 nuovamente la stessa destinazione, lineSetDevConfig può essere usato per ripristinare le impostazioni di configurazione selezionate dall'utente. È possibile usare le funzioni lineSetDevConfig, lineConfigDialoge 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. 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ò essere necessariamente passata ad altri dispositivi, anche della stessa classe di dispositivi (anche se questo può funzionare in alcuni casi, non è garantito).
Nota
L'intestazione tapi.h definisce lineGetDevConfig 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