Função phoneGetHookSwitch (tapi.h)

Artigo
03/05/2024

A função phoneGetHookSwitch retorna o modo hookswitch atual do dispositivo de telefone aberto especificado.

Sintaxe

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto.

lpdwHookSwitchDevs

Ponteiro para um DWORD a ser preenchido com o modo dos dispositivos hookswitch do telefone. Se uma posição de bit for FALSE, o dispositivo hookswitch correspondente estará ativado; se TRUE, o microfone e/ou a parte do alto-falante do dispositivo hookswitch correspondente estiver offhook. Para descobrir se o microfone e/ou o alto-falante estão habilitados, o aplicativo pode usar phoneGetStatus. Esse parâmetro usa uma ou mais constantes de PHONEHOOKSWITCHDEV_.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Comentários

Depois que o estado hookswitch de um dispositivo for alterado e se o monitoramento hookswitch estiver habilitado, o aplicativo será enviado uma mensagem PHONE_STATE .