LINE_LINEDEVSTATE mensagem

A mensagem LINE_LINEDEVSTATE TAPI é enviada quando o estado de um dispositivo de linha é alterado. O aplicativo pode invocar lineGetLineDevStatus para determinar o novo status da linha.

Parâmetros

hDevice

Um identificador para o dispositivo de linha. Esse parâmetro é NULL quando dwParam1 é LINEDEVSTATE_REINIT.

dwCallbackInstance

A instância de retorno de chamada fornecida ao abrir a linha. Se o parâmetro dwParam1 for LINEDEVSTATE_REINIT, o parâmetro dwCallbackInstance não será válido e será definido como zero.

Dwparam1

O dispositivo de linha status item que foi alterado. O parâmetro pode ser uma ou mais das constantes LINEDEVSTATE_.

Dwparam2

A interpretação desse parâmetro depende do valor de dwParam1. Se dwParam1 for LINEDEVSTATE_RINGING, dwParam2 conterá o modo de anel com o qual a opção instrui a linha a tocar. Modos de anel válidos são números no intervalo um a dwNumRingModes, em que dwNumRingModes é uma funcionalidade de dispositivo de linha.

Se dwParam1 for LINEDEVSTATE_REINIT e a mensagem tiver sido emitida pelo TAPI como resultado da tradução de uma nova mensagem de API em uma mensagem REINIT, dwParam2 conterá o parâmetro dwMsg da mensagem original (por exemplo, LINE_CREATE ou LINE_LINEDEVSTATE). Se dwParam2 for zero, isso indicará que a mensagem REINIT é uma mensagem REINIT "real" que exige que o aplicativo chame lineShutdown em sua primeira conveniência.

dwParam3

A interpretação desse parâmetro depende do valor de dwParam1. Se dwParam1 for LINEDEVSTATE_RINGING, dwParam3 conterá a contagem de anéis para esse evento de anel. A contagem de anéis começa em zero.

Se dwParam1 for LINEDEVSTATE_REINIT e a mensagem tiver sido emitida pelo TAPI como resultado da tradução de uma nova mensagem de API em uma mensagem REINIT, dwParam3 conterá o parâmetro dwParam1 da mensagem original (por exemplo, LINEDEVSTATE_TRANSLATECHANGE ou algum outro valor LINEDEVSTATE_, se dwParam2 for LINE_LINEDEVSTATE ou o novo identificador de dispositivo, se dwParam2 for LINE_CREATE).

Valor retornado

Sem valor de retorno.

Comentários

O envio da mensagem LINE_LINEDEVSTATE pode ser controlado com lineSetStatusMessages. Um aplicativo pode indicar status alterações de item sobre as quais deseja ser notificado. Por padrão, todos os relatórios de status estão desabilitados, exceto para LINEDEVSTATE_REINIT, que não podem ser desabilitados. Essa mensagem é enviada a todos os aplicativos que têm um identificador para a linha, incluindo aqueles que chamaram lineOpen com o parâmetro dwPrivileges definido como LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR ou combinações permitidas.

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 2.0 ou posterior
Cabeçalho	Tapi.h

Confira também

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

Linegetdevcaps

Linegetdevconfig

Linegettranslatecaps

Lineinitialize

Lineopen

lineSetStatusMessages

Lineshutdown

LINETRANSLATECAPS

lineUncompleteCall