função TSPI_phoneGetVolume (tspi.h)
A função TSPI_phoneGetVolume retorna a configuração de volume do dispositivo hookswitch do telefone especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetVolume(
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwVolume
);
Parâmetros
hdPhone
O identificador para o telefone que contém o dispositivo hookswitch cuja configuração de volume deve ser recuperada.
dwHookSwitchDev
Identifica um único dispositivo hookswitch cujo nível de volume é consultado. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHDEV_.
lpdwVolume
Um ponteiro para um local do tamanho de DWORD no qual o provedor de serviços grava a configuração de volume atual 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.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |