FSH FORCENOSWAP: Difference between revisions
Created page with "This function permanently forces segments into memory. ==Syntax== FSH_FORCENOSWAP(sel) ==Parameters== ;sel: is the selector that is to be made non-swappable. ==Returns==..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This function permanently forces segments into memory. | {{DISPLAYTITLE:FSH_FORCENOSWAP}} | ||
This function permanently forces segments into memory. | |||
==Syntax== | ==Syntax== | ||
FSH_FORCENOSWAP(sel) | FSH_FORCENOSWAP(sel) | ||
==Parameters== | ==Parameters== | ||
;sel: is the selector that is to be made non-swappable. | ;sel: is the selector that is to be made non-swappable. | ||
==Returns== | ==Returns== | ||
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned: | If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned: | ||
*ERROR_INVALID_ACCESS :indicates the selector is invalid. | |||
*ERROR_INVALID_DENIED :indicates the selector is invalid or the sector belongs to another process. | |||
*ERROR_DIRECT_ACCESS_HANDLE :indicates the handle does not refer to a segment. | |||
*ERROR_NOT_ENOUGH_MEMORY :indicates there is not enough physical memory to make a segment nonswappable. | |||
*ERROR_SWAP_TABLE_FULL :indicates the attempt to grow the swap file failed. | |||
*ERROR_SWAP_FILE_FULL :indicates the attempt to grow the swap file failed. | |||
*ERROR_PMM_INSUFFICIENT_MEMORY :indicates the attempt to grow the swap file failed. | |||
==Calling Sequence== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
| Line 34: | Line 24: | ||
unsigned short sel; | unsigned short sel; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
An FSD may call FSH_FORCENOSWAP to force segments to be loaded into memory and marked non-swappable. All segments both in the load image of the FSD and those allocated via FSH_SEGALLOC are eligible to be marked. There is no way to undo the effect of FSH_FORCENOSWAP. | An FSD may call FSH_FORCENOSWAP to force segments to be loaded into memory and marked non-swappable. All segments both in the load image of the FSD and those allocated via FSH_SEGALLOC are eligible to be marked. There is no way to undo the effect of FSH_FORCENOSWAP. | ||
If an FSD is notified it is managing the swapping media, it should make this call for the necessary segments. | If an FSD is notified it is managing the swapping media, it should make this call for the necessary segments. | ||
An FSD should be prepared to see multiple swapping files on more than one volume in 80386 processors and in future releases of OS/2. | An FSD should be prepared to see multiple swapping files on more than one volume in 80386 processors and in future releases of OS/2. | ||
FSH_FORCENOSWAP may block. | FSH_FORCENOSWAP may block. | ||
;Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | ;Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 22:06, 12 February 2020
This function permanently forces segments into memory.
Syntax
FSH_FORCENOSWAP(sel)
Parameters
- sel
- is the selector that is to be made non-swappable.
Returns
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:
- ERROR_INVALID_ACCESS :indicates the selector is invalid.
- ERROR_INVALID_DENIED :indicates the selector is invalid or the sector belongs to another process.
- ERROR_DIRECT_ACCESS_HANDLE :indicates the handle does not refer to a segment.
- ERROR_NOT_ENOUGH_MEMORY :indicates there is not enough physical memory to make a segment nonswappable.
- ERROR_SWAP_TABLE_FULL :indicates the attempt to grow the swap file failed.
- ERROR_SWAP_FILE_FULL :indicates the attempt to grow the swap file failed.
- ERROR_PMM_INSUFFICIENT_MEMORY :indicates the attempt to grow the swap file failed.
Calling Sequence
int far pascal FSH_FORCENOSWAP(sel) unsigned short sel;
Remarks
An FSD may call FSH_FORCENOSWAP to force segments to be loaded into memory and marked non-swappable. All segments both in the load image of the FSD and those allocated via FSH_SEGALLOC are eligible to be marked. There is no way to undo the effect of FSH_FORCENOSWAP.
If an FSD is notified it is managing the swapping media, it should make this call for the necessary segments.
An FSD should be prepared to see multiple swapping files on more than one volume in 80386 processors and in future releases of OS/2.
FSH_FORCENOSWAP may block.
- Note
- OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.