InterruptInitialize
This function initializes a hardware interrupt with the kernel. This initialization allows the device driver to register an event and enable the interrupt.
BOOL InterruptInitialize (
DWORD
idInt,
HANDLE hEvent,
LPVOID pvData,
DWORD cbData );
Parameters
- idInt
Interrupt identifier to be associated with this interrupt service thread (IST). - hEvent
Event to be signaled when the interrupt is triggered. - pvData
This parameter can be used as a pointer to a block of data that is passed to OEMInterruptEnable. The block of data may be initialization data, scratch space, and so on. - cbData
Size of data pointed to by pvData.
Return Values
TRUE indicates success; FALSE indicates failure.
Remarks
This function must be called prior to using the hEvent parameter, which provides a link between the idInt parameter and the SYSINTR value returned by an ISR. The hEvent parameter can only be used in a WaitForSingleObject API call to wait for the event to be triggered by the kernel. In previous releases of Windows CE hEvent could be used in a call to WaitForMultipleObjects. However, in Windows CE 3.0 a WaitForMultipleObjects call with hEvent will fail. If you use hEvent in a call to WaitForSingleObject before you call InterruptInitialize, InterruptInitialize will fail.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.10 and later | Pkfuncs.h |