função TSPI_phoneSetVolume (tspi.h)

Artigo
03/09/2024

A função TSPI_phoneSetVolume define o volume do componente do alto-falante do dispositivo hookswitch especificado para o nível especificado.

Sintaxe

LONG TSPIAPI TSPI_phoneSetVolume(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwHookSwitchDev,
  DWORD         dwVolume
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdPhone

O identificador para o telefone que contém o alto-falante cujo volume deve ser definido.

dwHookSwitchDev

Identifica o dispositivo hookswitch cujo volume do alto-falante deve ser definido. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHDEV_.

dwVolume

Um DWORD que especifica o novo nível de volume do dispositivo hookswitch. Esse é um número no intervalo de 0x00000000 (silêncio) até 0x0000FFFF (volume máximo). A granularidade real e a quantização das configurações de volume nesse intervalo são específicas do provedor de serviços. Um valor para dwVolume que está fora do intervalo é fixado por TAPI ao valor mais próximo no intervalo.

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou se for um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

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