(ФильтрВызываемыхСообщений)

Функция CallMsgFilter передает заданное сообщение и код hook-точки в подключаемые процедуры, связанные с hook-точками WH_MSGFILTER и WH_SYSMSGFILTER. Подключаемая процедура WH_SYSMSGFILTER или WH_MSGFILTER является определяемой программой функцией повторного вызова, которая исследует и, необязательно, модифицирует сообщения для диалогового окна, окна сообщений, меню или линейки прокрутки.

Синтаксис

BOOL CallMsgFilter
(
	LPMSG lpMsg,		// указатель на структуру с данными сообщения
	int nCode 		// код hook-точки
);

Параметры
lpMsg
Указатель на структуру MSG, содержащую сообщение, которое будет передано в подключаемые процедуры.
nCode
Устанавливает определяемый программой код, использованный подключаемой процедурой, чтобы определить, как обрабатывать сообщение. Код не должен иметь того же самого значения, что и определяемые системой коды hook-точек (MSGF_ и HC _) связанных с hook-точками WH_MSGFILTER и WH_SYSMSGFILTER.

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

Замечания
Windows вызывает CallMsgFilter, чтобы дать возможность прикладным программам проверять и управлять потоком сообщений в ходе внутренней обработки диалоговых окон, окон сообщений, меню и линеек прокрутки или, когда пользователь активизирует другое окно, нажимая комбинацию клавиш ALT+TAB.
Прикладная программа устанавливает подключаемую процедуру, используя функцию SetWindowsHookEx.

Смотри также
MessageProc, MSG, SetWindowsHookEx, SysMsgProc

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

Windows NT				Да 
Win95					Да 
Win32s					Да 
Импортируемая библиотека			user32.lib 
Заголовочный файл				winuser.h 
Unicode					Нет 
Замечания по платформе			Не имеется