função TSPI_phoneGetStatus (tspi.h)
A função TSPI_phoneGetStatus consulta o dispositivo de telefone aberto especificado para seu status geral.
Sintaxe
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Parâmetros
hdPhone
O identificador para o telefone a ser consultado.
lpPhoneStatus
Um ponteiro para uma estrutura de dados de tamanho variável do tipo PHONESTATUS, na qual o provedor de serviços grava informações sobre o status do telefone. Antes de chamar TSPI_phoneGetStatus, o aplicativo define o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.
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_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentários
A tabela a seguir indica quais membros da estrutura de dados PHONESTATUS são preenchidos pelo TAPI e quais membros são preenchidos pelo provedor de serviços. O provedor de serviços não deve substituir os valores preenchidos pelo TAPI.
| Membro | TAPI | Provedor de serviços |
|---|---|---|
| Dwtotalsize; | X | |
| Dwneededsize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
O TAPI pode usar essa função para determinar o estado atual de um dispositivo de telefone aberto. As informações de status descrevem informações sobre os dispositivos hookswitch do dispositivo de telefone, toque, volume, exibição e lâmpadas do telefone aberto.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |