MIL_ID ObjectId, | //in |
MIL_INT HookType, | //in |
MIL_OBJ_HOOK_FUNCTION_PTR HookHandlerPtr, | //in |
void *UserDataPtr | //in-out |
This function allows you to attach or detach a user-defined function to a specified object-related event. Once a hook-handler function is defined and hooked to an event, it is automatically called when the event occurs.
You can hook more than one function to an event by making separate calls to MobjHookFunction() for each function that you want to hook. MIL automatically chains and keeps an internal list of all these hooked functions. When a function is hooked, this new function is added to the end of the list. When the event happens, all user-defined functions in the list will be executed in the same order that they were hooked to the event. You can also remove any function from the list; in this case, MIL preserves the order of the remaining functions in the list.
You can obtain more information about the event from within the hook handler function using MobjGetHookInfo().
Specifies the object-related event on which to hook the function. This parameter can be set to one of the following values.
For all objects.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Hooks the function to the event that occurs when an object is freed. |
For message mailbox.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Hooks the function to the event that occurs when a message is received by the message mailbox. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Hooks the function to the event that occurs when a read operation times out. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Hooks the function to the event that occurs when a write operation times out. |
You can add the following value to the above-mentioned values to specify that the function should be unhooked.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Unhooks a hooked function. |
Specifies the address of the function that should be called when the specified event occurs. The hook-handler function must be declared as follows:
Type of event hooked.
Event identifier to pass to MobjGetHookInfo() when inquiring about the hooked event.
Specifies the user data pointer passed to MobjHookFunction().
Upon successful completion, the hook-handler function should return M_NULL. Note, MIL_OBJ_HOOK_FUNCTION_PTR and MFTYPE are reserved MIL predefined types for functions and data pointers.
Specifies the address of the user data that you want to make available to the hook-handler function. This address is passed to the hook-handler function, through its UserDataPtr parameter, when the specified event occurs. Set this parameter to M_NULL if not used.
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |