Método ITLegacyAddressMediaControl::SetDevConfig (tapi3if.h)

Artigo
03/05/2024

A função SetDevConfig permite que o aplicativo restaure a configuração de um dispositivo de fluxo de mídia em um dispositivo de linha para uma configuração obtida anteriormente usando GetDevConfig.

Sintaxe

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

Parâmetros

[in] pDeviceClass

Ponteiro para BSTR que contém a classe de dispositivo TAPI para a qual as informações de configuração são necessárias.

[in] dwSize

Tamanho da matriz de configuração.

[in] pDeviceConfig

Ponteiro para a matriz de bytes que contém informações de configuração do dispositivo obtidas por uma chamada para GetDevConfig.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pDeviceClass, pdwSize ou ppDeviceConfig não é um ponteiro válido.
E_INVALIDARG	O parâmetro pdwSize é zero.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

Esse método é um wrapper COM para a função lineSetDevConfig TAPI 2.1.

O GetID deve ser executado antes de chamar esse método.

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pDeviceClass e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Referências cruzadas do TAPI 2.1: lineGetDevConfig, lineSetDevConfig