DosCLIAccess

This function has been eliminated since OS/2 2.0 [1]

Description

This call requests I/O privilege for disabling and enabling interrupts. Access to ports must be granted with DosPortAccess.

Syntax

 DosCLIAccess

    ( )

Return Code

rc (USHORT) - return

Return code descriptions are:

• 0 NO_ERROR

Remarks

Applications that only use CLI/STI in IOPL segments must request CLI/STI privilege from the operating system.

Applications that use IN/OUT instructions to I/O ports must request I/O privilege with DosPortAccess. (See DosPortAccess for more detail.) Request for port access also grants CLI/STI privilege from the operating system.

Example Code

C Binding

#define INCL_DOSDEVICES

USHORT  rc = DosCLIAccess(VOID);


USHORT           rc;            /* return code */

Example

This example requests I/O privilege for disabling and enabling interrupts.

#define INCL_DOSDEVICES

USHORT rc;

   rc = DosCLIAccess();      /* Request I/O privilege */

MASM Binding

EXTRN  DosCLIAccess:FAR
INCL_DOSDEVICES     EQU 1

CALL   DosCLIAccess

Returns WORD