Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
VPICD_Install_Handler
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include bimodint.inc
 
les     di, bis             ; points to Bimodal_Int_Struc
mov     ax, VPICD_Install_Handler
call    [lpfnVPICD]
 
jc      error               ; carry set on error
 
The VPICD_Install_Handler function installs a bimodal interrupt handler for
the IRQ specified by the BIS_IRQ_Number field in the Bimodal_Int_Struc
structure.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
bis        Points to a Bimodal_Int_Struc structure containing information
           about the interrupt handler to install.
 
lpfnVPICD  Specifies the entry point address of the API handler for the
           virtual PIC device.
 
Return Value
 
If the carry flag is clear, the function is successful. Otherwise, the carry
flag is set to indicate an error such as the IRQ has already been
virtualized or the IRQ number is not valid.
 
Comments
 
This function virtualizes the specified IRQ and creates supervisor-mode
selectors for the interrupt handler's code, data, and additional segments
(if any). The function also sets the supervisor-mode API handler.
 
See Also
 
VPICD_Remove_Handler