função TSPI_phoneSetStatusMessages (tspi.h)
A função TSPI_phoneSetStatusMessages faz com que o provedor de serviços filtre status mensagens que atualmente não são de interesse de nenhum aplicativo.
Sintaxe
LONG TSPIAPI TSPI_phoneSetStatusMessages(
HDRVPHONE hdPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
Parâmetros
hdPhone
O identificador opaco para o telefone cujo filtro de monitoramento de alteração de estado deve ser definido.
dwPhoneStates
Sinalizadores que especificam o conjunto de status alterações e eventos para os quais a TAPI deseja receber mensagens de notificação. Esse parâmetro pode ter zero, um ou mais de uma das constantes PHONESTATE_.
dwButtonModes
Sinalizadores que especificam o conjunto de modos de botão do telefone para os quais o TAPI deseja receber mensagens de notificação. Se dwButtonModes for zero, dwButtonStates será ignorado. Esse parâmetro pode ter zero, um ou mais de uma das constantes PHONEBUTTONMODE_. Se dwButtonModes tiver pelo menos um desses sinalizadores definidos, dwButtonStates também deverá ter pelo menos um bit definido:
dwButtonStates
Esse parâmetro especifica o conjunto de alterações de estado do botão do telefone para o qual o TAPI deseja receber mensagens de notificação, uma das constantes PHONEBUTTONSTATE_.
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_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE PHONEERR_OPERATIONUNAVAIL.
Comentários
O TAPI define várias mensagens que notificam aplicativos sobre eventos que ocorrem em telefones. Os conjuntos de todas as mensagens de alteração nos quais todos os aplicativos estão interessados podem ser muito menores do que o conjunto de mensagens possíveis. Esse procedimento permite que a TAPI informe ao provedor de serviços o conjunto reduzido de mensagens a serem entregues. O provedor de serviços fornece todas as mensagens compatíveis, dentro do conjunto especificado. Ele tem permissão para entregar mais (eles são filtrados pelo TAPI), mas é desencorajado a fazê-lo por motivos de desempenho. Se o TAPI solicitar a entrega de um tipo de mensagem específico que não é produzido pelo provedor, o provedor, no entanto, aceitará a solicitação, mas simplesmente não produzirá a mensagem. Todas as mensagens de status de telefone, exceto PHONESTATE_REINIT, estão desabilitadas por padrão.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |