Device_Init

include vmm.inc

mov     ebx, SysVMHandle
mov     esi, OFFSET32 CommandTail
mov     eax, Device_Init
VMMcall System_Control

Directs the virtual device to initialize itself. The virtual device typically allocates memory for a device-specific section in the control block, allocates other memory areas, hooks interrupts and I/O ports, and specifies instance data. The virtual device may use all general registers and flags.

• The virtual device returns carry clear if it initialized successfully. If the virtual device returns carry set, the system considers the device as having failed to initialize and removes it from the list of VxDs loaded in the system. Before returning carry set, a virtual device must release all resources it had claimed during previous initialization phases.

SysVMHandle

Handle of the system virtual machine.

CommandTail

Address of the command tail retrieved from the program segment prefix (PSP) of VMM32.VXD. The first byte in the command tail specifies the length in bytes of the tail.

The virtual device should allocate a device-specific section in the control block of the system virtual machine and then initialize the section.

The virtual device can call the Simulate_Int and Exec_Int services in the system virtual machine.

For dynamically loaded VxDs, the EBX register does not contain a VM handle.

See also Init_Complete, Sys_Critical_Init