Notifiche (API di installazione)

Le notifiche sono valori che una funzione di installazione invia a una routine di callback per specificare uno stato o un evento. Due parametri, Param1 e Param2, vengono inviati con la notifica e contengono informazioni aggiuntive rilevanti per la notifica.

La routine di callback elabora la notifica e restituisce un intero senza segno alla funzione di installazione. A seconda della funzione di installazione, è possibile usare questo valore per specificare un'operazione o una selezione utente oppure ignorarla.

Le funzioni di installazione inviano notifiche alle routine di callback usando la sintassi seguente.

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

Il parametro Context è un puntatore void a una variabile di contesto o a una struttura che la routine di callback può usare per archiviare informazioni che devono essere persistenti tra le chiamate successive alla routine di callback.

Poiché la routine di callback specifica l'implementazione del contesto e non viene mai fatto riferimento o modificato dalle funzioni di installazione, il contesto non è documentato nel materiale di riferimento per i messaggi di notifica che seguono.

Il parametro Notifica specifica un valore intero senza segno per un evento o uno stato che causa la funzione di installazione di chiamare la routine di callback.

Param1 e Param2 sono parametri facoltativi che possono contenere informazioni aggiuntive pertinenti alla notifica. Questi parametri sono interi senza segno. Se Param1 o Param2 restituiscono informazioni che non sono un intero senza segno, viene eseguito il cast in un intero senza segno e deve essere ricastato nel tipo di dati originale prima che possa essere usato dalla routine di callback.

Le notifiche seguenti vengono usate dalle funzioni di installazione.