en:docs:fapi:dosmemavail

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 06:47 · prokushev
2021/08/20 05:18 · prokushev

DosMemAvail

This call returns the size of the largest block of free memory.

Syntax

DosMemAvail (MemAvailSize)

Parameters

  • MemAvailSize (PULONG) - output: Address of the size of the largest free block of memory in bytes.

Return Code

  • rc (USHORT) - return: Return code:
  • 0 NO_ERROR

Remarks

DosMemAvail allows an application to determine how heavily used system memory is at a particular time. The returned value is a “snapshot” that may be valid only at the moment this function is issued and can be expected to change at any time due to system activity.

This call can be used as an indicator for memory availability before a call to DosAllocHuge is made.

Bindings

C

#define INCL_DOSMEMMGR
USHORT  rc = DosMemAvail(MemAvailSize);
PULONG  MemAvailSize;  /* Size available (returned) */
USHORT  rc;            /* return code */

MASM

EXTRN  DosMemAvail:FAR
INCL_DOSMEMMGR      EQU 1
 
PUSH@  DWORD   MemAvailSize  ;Size available (returned)
CALL   DosMemAvail
 
Returns WORD

Note


en/docs/fapi/dosmemavail.txt · Last modified: 2021/09/15 04:48 by prokushev