__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