DosCLIAccess

Legacy Function Warning
It is recommended to use a newer replacement for this function.
Replacement:	N/A
Remarks:	This function has been eliminated since OS/2 2.0.

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

Syntax

DosCLIAccess ( )

Parameters

none

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. 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