Metodo ITLegacyAddressMediaControl::GetDevConfig (tapi3if.h)
Il metodo GetDevConfig restituisce una struttura di dati opaca. Il contenuto esatto è specifico del provider di servizi e della classe del dispositivo. La struttura dei dati specifica la configurazione di un dispositivo associato a un dispositivo linea specifico. 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 datamodem associato alla riga.
Sintassi
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
Parametri
[in] pDeviceClass
Puntatore a BSTR contenente la classe di dispositivo TAPI per cui sono necessarie le informazioni di configurazione.
[out] pdwSize
Puntatore alle dimensioni della matrice di configurazione.
[out] ppDeviceConfig
Puntatore a matrice di byte contenenti informazioni sulla configurazione del dispositivo.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pDeviceClass, pdwSize o ppDeviceConfig non è un puntatore valido. |
|
Memoria insufficiente per eseguire l'operazione. |
Commenti
Questo metodo è un wrapper COM per la funzione LineGetDevConfig TAPI 2.1.
È necessario eseguire GetID prima di chiamare questo metodo.
L'applicazione deve usare SysAllocString per allocare memoria per il parametro pDeviceClass e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.
L'applicazione deve chiamare la funzione CoTaskMemFree per liberare la memoria allocata per il parametro ppDeviceConfig .
TAPI 2.1 Riferimenti incrociati: lineGetDevConfig, lineSetDevConfig
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (include Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |