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