@node __dpmi_allocate_memory, dpmi
@subheading Syntax

@example
#include <dpmi.h>

int __dpmi_allocate_memory(__dpmi_meminfo *_info);
@end example

@subheading Description

Please refer to @ref{DPMI Specification} for details on DPMI
function call operation.  Also see @ref{DPMI Overview} for general
information.

DPMI function AX = 0x0501

This allocates virtual memory.  Fill in size, returns handle and address.

@subheading Return Value

-1 on error, else zero.

@subheading Portability

@portability !ansi, !posix