Функция MouseProc

Статья
07/01/2023

Описание

Определяемая приложением или библиотекой функция обратного вызова, используемая с функцией SetWindowsHookExA/SetWindowsHookExW . Система вызывает эту функцию всякий раз, когда приложение вызывает функцию GetMessage или PeekMessageA/PeekMessageW и появляется сообщение мыши для обработки.

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

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

Параметры

nCode [in]

Тип: int

Код, который используется процедурой перехватчика для определения способа обработки сообщения.

Если значение nCode меньше нуля, процедура перехватчика должна передать сообщение функции CallNextHookEx без дальнейшей обработки и возвращать значение, возвращаемое CallNextHookEx.

Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
HC_ACTION 0	Параметры wParam и lParam содержат сведения о сообщении мыши.
HC_NOREMOVE 3	Параметры wParam и lParam содержат сведения о сообщении мыши, и сообщение мыши не было удалено из очереди сообщений. (Приложение с именем функции PeekMessage , указывающее флаг PM_NOREMOVE .)

wParam [in]

Тип: WPARAM

Идентификатор сообщения мыши.

lParam [in]

Тип: LPARAM

Указатель на структуру MOUSEHOOKSTRUCT .

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

Тип: LRESULT

Если значение nCode меньше нуля, процедура перехватчика должна возвращать значение, возвращаемое CallNextHookEx.

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

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

Приложение устанавливает процедуру перехватчика, указывая тип перехватчика WH_MOUSE и указатель на процедуру перехватчика в вызове функции SetWindowsHookExASetWindowsHookExA /SetWindowsHookExW.

Процедура перехватчика не должна устанавливать функцию обратного вызова WH_JOURNALPLAYBACK .

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