DosCLIAccess: Difference between revisions
m Ak120 moved page OS2 API:CPI:LEGACY:DosCLIAccess to DosCLIAccess |
mNo edit summary |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Legacy | |||
This function has been eliminated since OS/2 2.0 [ | |RepFunc=N/A | ||
|Remarks=This function has been eliminated since OS/2 2.0. [http://books.google.com/books?id=u7WbsmbttwYC&pg=PT372] | |||
}} | |||
This call requests I/O privilege for disabling and enabling interrupts. Access to ports must be granted with DosPortAccess. | This call requests I/O privilege for disabling and enabling interrupts. Access to ports must be granted with DosPortAccess. | ||
==Syntax== | ==Syntax== | ||
DosCLIAccess () | |||
DosCLIAccess | |||
==Return Code== | ==Return Code== | ||
;rc (USHORT) - return: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. | ||
== | ==Bindings== | ||
===C | ===C=== | ||
<PRE> | <PRE> | ||
#define INCL_DOSDEVICES | #define INCL_DOSDEVICES | ||
USHORT rc = DosCLIAccess(VOID); | USHORT rc = DosCLIAccess(VOID); | ||
USHORT rc; /* return code */ | |||
</PRE> | |||
===MASM=== | |||
<PRE> | |||
EXTRN DosCLIAccess:FAR | |||
INCL_DOSDEVICES EQU 1 | |||
CALL DosCLIAccess | |||
Returns WORD | |||
</PRE> | </PRE> | ||
==Example== | |||
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 45: | Line 45: | ||
rc = DosCLIAccess(); /* Request I/O privilege */ | rc = DosCLIAccess(); /* Request I/O privilege */ | ||
</PRE> | </PRE> | ||
[[Category: | [[Category:Dos16]] | ||
Latest revision as of 00:30, 5 October 2023
 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. [1] |
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. Request for port access also grants CLI/STI privilege from the operating system.
Bindings
C
#define INCL_DOSDEVICES USHORT rc = DosCLIAccess(VOID); USHORT rc; /* return code */
MASM
EXTRN DosCLIAccess:FAR INCL_DOSDEVICES EQU 1 CALL DosCLIAccess Returns WORD
Example
This example requests I/O privilege for disabling and enabling interrupts.
#define INCL_DOSDEVICES USHORT rc; rc = DosCLIAccess(); /* Request I/O privilege */