Função phoneSetHookSwitch (tapi.h)
A função phoneSetHookSwitch define o estado do gancho dos dispositivos hookswitch do telefone aberto especificado para o modo especificado. Somente o estado hookswitch dos dispositivos hookswitch listados é afetado.
Sintaxe
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
Parâmetros
hPhone
Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.
dwHookSwitchDevs
Dispositivo cujo modo hookswitch deve ser definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHDEV_.
PHONEHOOKSWITCHDEV_HANDSET
O aparelho do telefone.
PHONEHOOKSWITCHDEV_SPEAKER
O viva-voz do telefone ou adjunto.
PHONEHOOKSWITCHDEV_HEADSET
O fone de ouvido do telefone.
dwHookSwitchMode
Modo hookswitch a ser definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHMODE_.
PHONEHOOKSWITCHMODE_ONHOOK
O microfone e o alto-falante do dispositivo são ambos onhook.
PHONEHOOKSWITCHMODE_MIC
O microfone do dispositivo está ativo, o alto-falante está mudo.
PHONEHOOKSWITCHMODE_SPEAKER
O alto-falante do dispositivo está ativo, o microfone está mudo.
PHONEHOOKSWITCHMODE_MICSPEAKER
O microfone e o alto-falante do dispositivo estão ativos.
Retornar valor
Retornará um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE PHONEERR_UNINITIALIZED.
Comentários
O modo hookswitch é o mesmo para todos os dispositivos especificados. Se forem desejadas configurações diferentes, essa função poderá ser invocada várias vezes com um conjunto diferente de parâmetros. Uma mensagem PHONE_STATE é enviada ao aplicativo depois que o estado hookswitch é alterado.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |