IOCTL_HAL_REQUEST_SYSINTR (Windows Embedded CE 6.0)

1/5/2010

This I/O control requests an interrupt request-to-system interrupt (IRQ-to-SYSINTR) mapping for bus drivers.

Parameters

• dwIoControlCode
  [in] Set to IOCTL_HAL_REQUEST_SYSINTR.

• lpInBuf
  [in] IRQ to translate into a SYSINTR.

• nInBufSize
  [in] Size of lpInBuf.

• lpOutBuf
  [out] SYSINTR translated from an IRQ.

• nOutBufSize
  [out] Size of lpOutBuf.

• lpBytesReturned
  [in] If not NULL, set to size of DWORD.

Return Values

Returns true if the function succeeds; otherwise, false.

Remarks

The OEMIoControl function calls this IOCTL.

A bus driver reads its SYSINTR value from the registry. It also reads the IRQ value, if necessary. If the driver is for a built-in device, it sets up the mapping in the OEMInit function and place the SYSINTR in the associated registry entry for the device. Bus drivers, such as the PCI bus driver, use IOCTL_HAL_REQUEST_SYSINTR to allocate SYSINTRs and subsequently populate the registry for the device it is loading a driver for.

Requirements

See Also

Reference

CEDDK IOCTLs
IOCTL_HAL_TRANSLATE_IRQ
IOCTL_HAL_RELEASE_SYSINTR
OEMInit
OEMIoControl

Other Resources

Controlling Debug Message Output With Macros
NdisMRegisterInterrupt
Installable ISRs and the Kernel