Metodo ITLegacyAddressMediaControl::SetDevConfig (tapi3if.h)

Articolo
03/02/2024

La funzione SetDevConfig 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 GetDevConfig.

Sintassi

HRESULT SetDevConfig(
  [in] BSTR  pDeviceClass,
  [in] DWORD dwSize,
  [in] BYTE  *pDeviceConfig
);

Parametri

[in] pDeviceClass

Puntatore a BSTR contenente la classe di dispositivo TAPI per cui sono necessarie informazioni di configurazione.

[in] dwSize

Dimensioni della matrice di configurazione.

[in] pDeviceConfig

Puntatore alla matrice di byte contenenti informazioni sulla configurazione del dispositivo ottenute da una chiamata a GetDevConfig.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pDeviceClass, pdwSize o ppDeviceConfig non è un puntatore valido.
E_INVALIDARG	Il parametro pdwSize è zero.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

Questo metodo è un wrapper COM per la funzione lineSetDevConfig TAPI 2.1.

Il getID deve essere eseguito 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.

TAPI 2.1 Riferimenti incrociati: lineGetDevConfig, lineSetDevConfig