Jump to content

DosCLIAccess: Difference between revisions

From EDM2
Ak120 (talk | contribs)
Ak120 (talk | contribs)
mNo edit summary
Line 1: Line 1:
[[image:legacy.png]]
This call requests I/O privilege for disabling and enabling interrupts. Access to ports must be granted with DosPortAccess.  
This function has been eliminated since OS/2 2.0 [https://books.google.com.ec/books?id=u7WbsmbttwYC&pg=PT372&lpg=PT372&dq#v=onepage&q&f=false]


==Description==
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==
==Syntax==
<PRE>
  DosCLIAccess ( )
  DosCLIAccess


    ( )
</PRE>
==Parameters==
==Parameters==
none


==Return Code==
==Return Code==
  rc (USHORT) - return
  rc (USHORT) - return
Return code descriptions are:
Return code descriptions are:
*0    NO_ERROR


*0    NO_ERROR
==Remarks==
==Remarks==
Applications that only use CLI/STI in IOPL segments must request CLI/STI privilege from the operating system.
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.  
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==
==Example Code==
Line 37: Line 32:


This example requests I/O privilege for disabling and enabling interrupts.
This example requests I/O privilege for disabling and enabling interrupts.
<PRE>
<PRE>
#define INCL_DOSDEVICES
#define INCL_DOSDEVICES
Line 57: Line 51:
*  
*  


 
[[Category:Dos]]
[[Category:The OS/2 API Project]]

Revision as of 10:01, 14 February 2017

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

This function has been eliminated since OS/2 2.0.

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

Related Functions