Disables the specified interrupt level and the interrupt controller. It has no effect on other levels. You must not disable the level reserved for the system clock at system configuration.

BOOLEAN DisableRtInterrupt(
    WORD wLevel
);

Parameters

wLevel

Encoded interrupt level.

Remarks

To be disabled, a level must have an interrupt handler assigned to it. Otherwise, the RT kernel returns an E_CONTEXT status code.

Warning: this call is not intended to be used to temporarily disable an interrupt source during runtime. In general if an interrupt occurs which masked in this way the interrupt will be lost.

To temporarily disable an interrupt you need to disable it at the hardware source, which requires specific knowledge of the device generating the interrupt.

Return Values

TRUE

Success

FALSE

To determine the status, call GetLastRtError

Status

E_CONTEXT 0x0005

wLevel specifies an already disabled level or a level with no interrupt handler assigned.

E_PARAM 0x8004

wLevel contains an invalid value.

Requirements