www.delorie.com/djgpp/doc/libc/libc_229.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

__dpmi_get_memory_information

Syntax

 
#include <dpmi.h>

int __dpmi_get_memory_information(__dpmi_memory_info *buffer);

Description

Please refer to the DPMI Specification (see section DPMI Specification) for details on DPMI function call operation. Also see the DPMI Overview (see section DPMI Overview) for general information.

DPMI function AX = 0x050b (DPMI 1.0 only). Not supported by CWSDPMI and Windows.

This function returns virtual memory information, as follows:

total_allocated_bytes_of_physical_memory_host
The total amount of allocated physical memory controlled by the DPMI host.

total_allocated_bytes_of_virtual_memory_host
The total amount of allocated virtual memory controlled by the DPMI host.

total_available_bytes_of_virtual_memory_host
The total amount of available virtual memory controlled by the DPMI host.

total_allocated_bytes_of_virtual_memory_vcpu
The amount of virtual memory allocated by the DPMI host for the current virtual machine.

total_available_bytes_of_virtual_memory_vcpu
The amount of virtual memory available for the current virtual machine.

total_allocated_bytes_of_virtual_memory_client
The amount of virtual memory allocated by the DPMI host for the current client (that is, for the calling program).

total_available_bytes_of_virtual_memory_client
The amount of virtual memory available to the current client.

total_locked_bytes_of_memory_client
The amount of memory locked by the calling program.

max_locked_bytes_of_memory_client
Maximum locked memory for the current client.

highest_linear_address_available_to_client
The highest linear address available to the calling program.

size_in_bytes_of_largest_free_memory_block
Size of the largest available memory block.

size_of_minimum_allocation_unit_in_bytes
Size of the smallest block that can be allocated.

size_of_allocation_alignment_unit_in_bytes
The alignment of allocated memory blocks.

Return Value

-1 on error, else zero.

Portability

ANSI/ISO C No
POSIX No


  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2004   by DJ Delorie     Updated Apr 2004