Функция LowLevelKeyboardProc

Процедура фильтра (hook) LowLevelKeyboardProc - определяемая программой или определяемая библиотекой функция повторного вызова, используемая функцией SetWindowsHookEx. Система вызывает эту функцию каждый раз, когда собирается вставить новое событие ввода с клавиатуры в очередь ввода данных потока. Ввод с клавиатуры может исходить от локального драйвера клавиатуры или от вызовов функции keybd_event. Если ввод данных исходит из вызова keybd_event, ввод данных  "вставляется". Однако, фильтр (hook) WH_KEYBOARD_LL не вставляется в другой процесс. Вместо этого, контекст переключается обратно в процесс, который устанавливал фильтр (hook), и  вызывается в его первоначальном контексте. Затем контекст переключается обратно в приложение, которое создало событие.

Тип HOOKPROC определяет указатель на эту функцию повторного вызова. LowLevelKeyboardProc - это имя - заместитель для определяемого программой или определяемого библиотекой имени функции.

Синтаксис

LRESULT CALLBACK LowLevelKeyboardProc(      
    int nCode,
    WPARAM wParam,
    LPARAM lParam
);

Параметры

nCode

[in] Устанавливает код использования процедуры фильтра (hook), чтобы решить, как обработать сообщение. Если nCode - меньше чем нуль, процедура фильтра (hook) должна передать сообщение в функцию CallNextHookEx без дальнейшей обработки и должна возвратить значение, возвращенное CallNextHookEx. Этим параметром может быть одно из ниже перечисленных значений.
Значение Предназначение
HC_ACTION Параметры wParam и lParam содержат информацию о сообщении клавиатуры.
 

wParam

[in] Устанавливает идентификатор сообщения клавиатуры. Этим параметром может быть одно из ниже перечисленных сообщений: WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN или WM_SYSKEYUP.

lParam

[in] Указатель на структуру KBDLLHOOKSTRUCT.

Возвращаемое значение

Если nCode - меньше чем нуль, процедура фильтра (hook) должна возвратить значение, возвращенное CallNextHookEx.

Если nCode больше или равен нулю, а процедура фильтра (hook) не обрабатывала сообщение, очень рекомендуется, чтобы Вы вызвали CallNextHookEx и возвратили значение, которое она возвращает; в противном случае, другие прикладные программы, которые установили фильтры (hook) WH_KEYBOARD_LL, не будут получать уведомления фильтра (hook) и, в результате, могут повести себя неправильно. Если процедура фильтра (hook) обрабатывала сообщение, она может возвратить ненулевое значение, чтобы воспрепятствовать системе передавать сообщение в остальную часть цепочки фильтра (hook) или в целевую оконную процедуру.

Замечания

Приложение устанавливает процедуру фильтра (hook), определяя тип фильтра как WH_KEYBOARD_LL и указатель на процедуру фильтра при вызове функции SetWindowsHookEx.

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

Процедура фильтра (hook) должна обработать сообщение скорее, чем ввод  данных, указанных в значении LowLevelHooksTimeout в следующем ниже ключе системного реестра:

HKEY_CURRENT_USER  \Control Panel  \Desktop

Значение исчисляется в миллисекундах. Если процедура фильтра (hook) не возвращает значение в течение этого интервала, система переправит сообщение в следующий фильтр (hook).

Обратите внимание! на то, что отладочные фильтры не могут отслеживать  этот тип фильтра (hook).

Смотри также

Обзор Фильтр-процедуры (hooks) событий, Функции, используемые фильтрами (hook), CallNextHookExKBDLLHOOKSTRUCT keybd_eventSetWindowsHookExWH_KEYBOARD_LL WM_KEYDOWNWM_KEYUP WM_SYSKEYDOWN WM_SYSKEYUP

Размещение и совместимость LowLevelKeyboardProc

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 4.0 SP3 и выше

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Нет

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz