função TSPI_phoneGetHookSwitch (tspi.h)
A função TSPI_phoneGetHookSwitch retorna o modo hookswitch atual do dispositivo de telefone aberto especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetHookSwitch(
HDRVPHONE hdPhone,
LPDWORD lpdwHookSwitchDevs
);
Parâmetros
hdPhone
A alça opaca do provedor de serviços para o telefone cujo modo hookswitch deve ser recuperado.
lpdwHookSwitchDevs
Um ponteiro para um local do tamanho DWORD no qual o provedor de serviços grava o modo dos dispositivos hookswitch do telefone. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHDEV_. Se uma posição de bit for FALSE, o dispositivo hookswitch correspondente será onhook. Se TRUE, a parte do microfone e/ou alto-falante do dispositivo hookswitch correspondente estará offhook. Para descobrir se o microfone e/ou o alto-falante estão habilitados, o TAPI pode usar TSPI_phoneGetStatus.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentários
Depois que o estado hookswitch de um dispositivo for alterado e se o monitoramento hookswitch estiver habilitado, o TAPI será enviado um PHONE_STATE mensagem.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |