VDDInstallUserHook

BOOL VDDInstallUserHook(hVDD, Ucr_Handler, Uterm_Handler, Ublock_handler,
Uresume_handler)
IN HANDLE hVDD;
IN PFNVDD_UCREATE Ucr_Handler;
IN PFNVDD_UTERMINATE Uterm_Handler;
IN PFNVDD_UBLOCK Ublock_handler;
IN PFNVDD_URESUME Uresume_handler;

VDDInstallUserHook hooks callback events. These callback events include PDB (DOS process) creation, PDB termination, VDM block and VDM resume.

Parameters

hVDD

Identifies the VDD.

Ucr_Handler

Function which will be called on PDB creation (optional). Entry: 16-bit DOS PDB; exit: none.

Uterm_handler

Function which will be called on PDB termination (optional). Entry: 16-bit DOS PDB; exit:none.

Ublock_handler

Function which will be called when NTVDM is blocked (optional).

Uresume_handler

Function which will be called with NTVDM resumes (optional).

Return Value

VDDInstallUserHook returns TRUE if successful. GetLastError (see the Win32 SDK) has extended error information.

Comments

The VDD can provide whatever event hook it may choose. Not providing a handler has no effect.

See Also

VDDDeInstallUserHook