Metodo ITLegacyAddressMediaControl2::ConfigDialogEdit (tapi3if.h)
Il metodo ConfigDialogEdit causa la visualizzazione di una finestra di dialogo del provider del dispositivo della riga specificata per consentire all'utente di configurare i parametri correlati al dispositivo della riga. I dati di configurazione vengono passati e fuori da questo metodo dall'applicazione. I dati sono uguali a quello recuperato dal metodo ITLegacyAddressMediaControl::GetDevConfig e impostato dal metodo ITLegacyAddressMediaControl::SetDevConfig .
Sintassi
HRESULT ConfigDialogEdit(
[in] HWND hwndOwner,
[in] BSTR pDeviceClass,
[in] DWORD dwSizeIn,
[in] BYTE *pDeviceConfigIn,
[out] DWORD *pdwSizeOut,
[out] BYTE **ppDeviceConfigOut
);
Parametri
[in] hwndOwner
Handle a una finestra a cui collegare la finestra di dialogo. Può essere NULL per indicare che una finestra creata dal metodo non deve avere alcuna finestra di proprietario.
[in] pDeviceClass
Puntatore a un BSTR che specifica un nome della classe di dispositivo. Questa classe di dispositivo consente all'applicazione di selezionare una sottoscreen specifica delle informazioni di configurazione applicabili a tale classe di dispositivo. Questo parametro è facoltativo e può essere lasciato NULL o vuoto, nel qual caso è selezionata la configurazione di livello più alto.
[in] dwSizeIn
Puntatore alle dimensioni dei dati di configurazione a cui punta il parametro pDeviceConfigIn .
[in] pDeviceConfigIn
Puntatore a una matrice di byte contenenti i dati di configurazione del dispositivo da modificare.
[out] pdwSizeOut
Puntatore alle dimensioni dei dati di configurazione a cui punta il parametro ppDeviceConfigOut .
[out] ppDeviceConfigOut
Puntatore a una matrice di byte contenenti dati di configurazione del dispositivo modificati.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Questo metodo si traduce in un TAPI 2. Chiamata xlineConfigDialogEdit . Il metodo ITLegacyAddressMediaControl2::ConfigDialog converte in una chiamata lineConfigDialog . Questi metodi differiscono nell'origine dei parametri da modificare e il risultato della modifica in una connessione attiva. Per una discussione su queste differenze, vedere lineConfigDialogEdit.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |