Go to the first, previous, next, last section, table of contents.


__dpmi_get_memory_information

Syntax

#include <dpmi.h>

int __dpmi_get_memory_information(__dpmi_memory_info *buffer);

Description

Please refer to section DPMI Specification for details on DPMI function call operation. Also 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

not ANSI, not POSIX


Go to the first, previous, next, last section, table of contents.