ActiveREI

Synopsis

rei = ActiveREI()
D0

C Prototype

struct REI *ActiveREI(void);

Description

Returns a pointer to the currently active REI structure. This is the REI associated with the currently active Window.

This function requires that a Window is selected and active. In the unlikely case that the REI consists only of a screen (edge case), this function will FAIL.

Inputs

None.

Result

• rei — Address of a REI structure. If NULL, the currently active Window was not opened by the REI system, indicating an error.

See Also

FindREI, OpenREIA

Implementation

The original 68020 assembly implementation:

; (V41) - 20-Sep-1994 --- ActiveREI()
_LVOActiveREI
        movem.l a5-a6,-(sp)
        move.l  ab_IntuiBase(a6),a6
        moveq   #0,d0
        jsr     _LVOLockIBase(a6)
        move.l  d0,a0
        move.l  ib_ActiveWindow(a6),a5
        jsr     _LVOUnlockIBase(a6)
        move.l  wd_UserData(a5),d0
        movem.l (sp)+,a5-a6
        rts