WD_IntEnable

#define WD_IntEnable	(		h,
			pInterrupt
	)		WD_FUNCTION(IOCTL_WD_INT_ENABLE, h, pInterrupt, sizeof(WD_INTERRUPT), FALSE)

Registers an interrupt service routine (ISR) to be called upon interrupt.

Parameters

[in]	h	Handle to WinDriver's kernel-mode driver as received from WD_Open()
[in,out]	pInterrupt	Pointer to an interrupt information structure

Returns

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise

Remarks

For more information regarding interrupt handling please refer to the Interrupts section in the WinDriver PCI Manual.

kpCall is relevant for Kernel PlugIn implementation.

WinDriver must be registered with the OS as the driver of the device before enabling interrupts. For Plug-and-Play hardware (PCI/PCI Express) on Windows platforms, this association is made by installing an INF file for the device. If the INF file is not installed, WD_IntEnable() will fail with a WD_NO_DEVICE_OBJECT error.

WD_INTERRUPT intrp;
WD_CARD_REGISTER cardReg;
 
BZERO(cardReg);
 
cardReg.Card.dwItems = 1;
cardReg.Card.Item[0].item = ITEM_INTERRUPT;
cardReg.Card.Item[0].fNotSharable = 1;
cardReg.Card.Item[0].I.Int.dwInterrupt = 10; /* IRQ 10 */
 
/* INTERRUPT_LEVEL_SENSITIVE - set to level-sensitive
     interrupts, otherwise should be 0.
     ISA cards are usually Edge Triggered while PCI cards
     are usually Level Sensitive. */
cardReg.Card.Item[0].I.Int.dwOptions =
    INTERRUPT_LEVEL_SENSITIVE;
cardReg.fCheckLockOnly = FALSE;
 
WD_CardRegister(hWD, &cardReg);
if (cardReg.hCard == 0)
{
    printf("Could not lock device\n");
}
else
{
    BZERO(intrp);
 
    intrp.hInterrupt = cardReg.Card.Item[0].I.Int.hInterrupt;
    intrp.Cmd = NULL;
    intrp.dwCmds = 0;
    intrp.dwOptions = 0;
 
    WD_IntEnable(hWD, &intrp);
}
 
if (!intrp.fEnableOk)
{
    printf("Failed enabling interrupt\n");
}

Definition at line 2643 of file windrvr.h.