OALIntrRequestSysIntr (Windows CE 5.0)

Send Feedback

This function allocates a new SYSINTR value for a specified IRQ list. Based on the flags parameter, it can also set backward static mapping of IRQs to SYSINTR logical interrupts.

UINT32 OALIntrRequestSysIntr(  UINT32 count,  const UINT32 *pIrqs,  UINT32 flags);

Parameters

  • count
    [in] Number of IRQs that are mapped to the SYSINTR returned by the function. The standard library does not support mapping multiple IRQs to one SYSINTR; a value of 1 for the count parameter is supported.
  • pIrqs
    [in] Pointer to the list of IRQs.
  • flags
    [in] Flags to specify the type of IRQ to SYSINTR mapping. The following table shows the valid flags for this parameter.
    Flag Description
    OAL_INTR_DYNAMIC Specifies the use of non-static mapping of a SYSINTR to an IRQ will be used.
    OAL_INTR_STATIC Indicates a request for static mapping of a SYSINTR to an IRQ. If this is not the first request for a given IRQ, the function fails when this flag is used.
    OAL_INTR_FORCE_STATIC Indicates a request to force static mapping of an IRQ to a SYSINTR even if static mapping for the IRQ is already assigned.
    OAL_INTR_TRANSLATE Specifies the use of the obsolete IOCTL_HAL_TRANSLATE_IRQ semantic. In this case, if static mapping exists for the IRQ, the function returns a mapped SYSINTR. Otherwise, it creates a new mapping.

Return Values

Returns the associated SYSINTR value.

Remarks

When a value of 0 is passed in the flags parameter, a backward compatible mapping method is used that creates static mapping if static mapping is possible.

The first request for a given IRQ creates static mapping of a SYSINTR to an IRQ.

Requirements

OS Versions: Windows CE Version 5.0 and later
Header: Oal_intr.h
Link Library: Developer-defined

See Also

Interrupt Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.