Notificações (API de configuração)

Notificações são valores que uma função de instalação envia para uma rotina de retorno de chamada para especificar um estado ou evento. Dois parâmetros, Param1 e Param2, são enviados com a notificação e contêm informações adicionais relevantes para a notificação.

A rotina de retorno de chamada processa a notificação e retorna um inteiro não assinado para a função de configuração. Dependendo da função de configuração, você pode usar esse valor para especificar uma operação ou seleção de usuário, ou você pode ignorá-lo.

As funções de configuração enviam notificações para rotinas de retorno de chamada usando a sintaxe a seguir.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

O parâmetro Context é um ponteiro vazio para uma variável ou estrutura de contexto que a rotina de retorno de chamada pode usar para armazenar informações que devem persistir entre chamadas subsequentes para a rotina de retorno de chamada.

Como a rotina de retorno de chamada especifica a implementação do contexto e nunca é referenciada ou alterada pelas funções de instalação, o contexto não é documentado no material de referência para as mensagens de notificação a seguir.

O parâmetro Notification especifica um valor inteiro não assinado para um evento ou estado que faz com que a função de instalação chame a rotina de retorno de chamada.

Param1 e Param2 são parâmetros opcionais que podem conter informações adicionais relevantes para a notificação. Esses parâmetros são inteiros não assinados. Se Param1 ou Param2 retornar informações que não sejam um número inteiro não assinado, elas serão convertidas em um inteiro não assinado e deverão ser reformuladas para seu tipo de dados original antes de poderem ser usadas pela rotina de retorno de chamada.

As notificações a seguir são usadas pelas funções de configuração.