Função phoneGetVolume (tapi.h)

Artigo
03/05/2024

A função phoneGetVolume retorna a configuração de volume do dispositivo hookswitch do telefone especificado.

Sintaxe

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto.

dwHookSwitchDev

Um único dispositivo hookswitch cujo nível de volume é consultado. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHDEV_.

lpdwVolume

Ponteiro para um DWORD. A função retorna a configuração de volume atual do dispositivo hookswitch nesse local. 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 volume 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_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi.h
Biblioteca	Tapi32.lib
DLL	Tapi32.dll

Confira também

Funções de serviço de telefonia suplementar

Visão geral da referência do TAPI 2.2

Share via