phoneSetGain

9/19/2008

Essa função define o ganho do microfone do dispositivo de gancho especificado para o especificado obtenham nível.

Observação

Essa função é TAPI versão 2.0 e posterior.

Syntax

LONG WINAPI phoneSetGain(
  HPHONE hPhone,
  DWORD dwHookSwitchDev,
  DWORD dwGain 
);

Parameters

• hPhone
  Identificador para o aberto dispositivo telefônico. O aplicativo deve ser o proprietário do telefone.

• dwHookSwitchDev
  Dispositivo Hookswitch obter do microfone cujo deve ser definido. Este parâmetro usa um e apenas um do PHONEHOOKSWITCHDEV Constantes.

• dwGain
  Ponteiro para um DWORD que contém a nova configuração Ganho do dispositivo. O dwGain parâmetro especifica o ganho nível do dispositivo de gancho. Este é um número no intervalo 0 x 00000000 (silêncio) a 0x0000FFFF (volume máximo). O real granularidade e quantization das configurações ganho esse intervalo são service_provider-específicos. Um valor para dwGain Isto é out of intervalo é definido como o valor mais próximo no intervalo.

Return Value

Retorna um identificador positivo solicitação se a função for de forma assíncrona concluída ou um número negativo erro se ocorrer um erro. O dwParam2 parâmetro do correspondente PHONE_REPLY mensagem será zero se a função é bem-sucedida ou é um número negativo erro se ocorrer um erro. A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
PHONEERR_INVALPHONEHANDLE	O identificador para o aberto dispositivo de telefone é inválido.
PHONEERR_NOMEM	Não há memória o suficiente disponível.
PHONEERR_NOTOWNER	O aplicativo não é o proprietário deste chamar.
PHONEERR_RESOURCEUNAVAIL	Os recursos são não disponível.
PHONEERR_INVALPHONESTATE	O estado de telefone é inválido.
PHONEERR_OPERATIONFAILED	A operação falhou.
PHONEERR_INVALHOOKSWITCHDEV	O dispositivo gancho é inválido.
PHONEERR_UNINITIALIZED	Um parâmetro é não inicializado.
PHONEERR_OPERATIONUNAVAIL	A operação é não disponível.

Requirements

Header	tapi.h
Library	coredll.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later