Уведомления (API установки)

Уведомления — это значения, которые функция установки отправляет в подпрограмму обратного вызова для указания состояния или события. Два параметра, Param1 и Param2, отправляются вместе с уведомлением и содержат дополнительные сведения, относящиеся к уведомлению.

Подпрограмма обратного вызова обрабатывает уведомление и возвращает целое число без знака в функцию установки. В зависимости от функции установки это значение можно использовать, чтобы указать операцию или выбор пользователя, или пропустить его.

Функции установки отправляют уведомления подпрограммам обратного вызова, используя следующий синтаксис.

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

Параметр Context — это пустой указатель на переменную контекста или структуру, которую подпрограмма обратного вызова может использовать для хранения сведений, которые должны сохраняться между последующими вызовами процедуры обратного вызова.

Так как подпрограмма обратного вызова определяет реализацию контекста и на нее никогда не указываются и не изменяются функциями установки, контекст не задокументирован в справочных материалах для последующих сообщений уведомлений.

Параметр Notification задает целочисленное значение без знака для события или состояния, которое приводит к тому, что функция установки вызывает подпрограмму обратного вызова.

Param1 и Param2 являются необязательными параметрами, которые могут содержать дополнительные сведения, относящиеся к уведомлению. Эти параметры являются целыми числами без знака. Если Param1 или Param2 возвращают сведения, которые не являются целым числом без знака, оно приводится к целому типу без знака и должно быть переадресовано в исходный тип данных, прежде чем его можно будет использовать в процедуре обратного вызова.

Следующие уведомления используются функциями установки.