Função phoneSetHookSwitch (tapi.h)

  • Artigo

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

Confira também

PHONE_REPLY

PHONE_STATE

Funções complementares do Serviço de Telefonia

Visão geral da referência do TAPI 2.2