DosCLIAccess: Difference between revisions
Appearance
m Ak120 moved page OS2 API:CPI:LEGACY:DosCLIAccess to DosCLIAccess |
mNo edit summary |
||
Line 1: | Line 1: | ||
This call requests I/O privilege for disabling and enabling interrupts. Access to ports must be granted with DosPortAccess. | |||
This | |||
This function has been eliminated since OS/2 2.0. | |||
This | |||
==Syntax== | ==Syntax== | ||
DosCLIAccess ( ) | |||
DosCLIAccess | |||
==Parameters== | ==Parameters== | ||
none | |||
==Return Code== | ==Return Code== | ||
rc (USHORT) - return | rc (USHORT) - return | ||
Return code descriptions are: | Return code descriptions are: | ||
*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. | 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: |
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