Função phoneGetGain (tapi.h)

A função phoneGetGain retorna a configuração de ganho do microfone do dispositivo hookswitch do telefone especificado.

Sintaxe

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto.

dwHookSwitchDev

Dispositivo Hookswitch cujo nível de ganho é consultado. O parâmetro dwHookSwitchDev pode ter apenas um bit definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHDEV_.

lpdwGain

Ponteiro para um DWORD que contém a configuração de ganho atual do componente de microfone hookswitch. O parâmetro dwGain especifica o nível de volume do dispositivo hookswitch. Esse é um número no intervalo 0x00000000 (silêncio) para 0x0000FFFF (volume máximo). A granularidade real e a quantização das configurações de ganho nesse intervalo são específicas do provedor de serviços.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Requisitos

Confira também

Funções de serviço de telefonia suplementar

Visão geral da referência do TAPI 2.2