Método ITLegacyAddressMediaControl::GetDevConfig (tapi3if.h)
O método GetDevConfig retorna uma estrutura de dados opaca. O conteúdo exato é específico para o provedor de serviços e a classe de dispositivo. A estrutura de dados especifica a configuração de um dispositivo associado a um dispositivo de linha específico. Por exemplo, o conteúdo dessa estrutura pode especificar a taxa de dados, o formato de caractere, os esquemas de modulação e as configurações de protocolo de controle de erro para um dispositivo datamodem associado à linha.
Sintaxe
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
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.
[out] pdwSize
Ponteiro para o tamanho da matriz de configuração.
[out] ppDeviceConfig
Ponteiro para a matriz de bytes que contém informações de configuração do dispositivo.
Retornar valor
Esse método pode retornar um desses valores.
Código de retorno | Descrição |
---|---|
|
O método foi bem-sucedido. |
|
O parâmetro pDeviceClass, pdwSize ou ppDeviceConfig não é um ponteiro válido. |
|
Existe memória insuficiente para executar a operação. |
Comentários
Esse método é um wrapper COM para a função TAPI 2.1 LineGetDevConfig .
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.
O aplicativo deve chamar a função CoTaskMemFree para liberar a memória alocada para o parâmetro ppDeviceConfig .
Referências cruzadas do TAPI 2.1: lineGetDevConfig, lineSetDevConfig
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | tapi3if.h (inclua Tapi3.h) |
Biblioteca | Uuid.lib |
DLL | Tapi3.dll |