__dpmi_allocate_shared_memory

Syntax

#include <dpmi.h> int __dpmi_allocate_shared_memory(__dpmi_shminfo *info);

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 = 0x0d00 (DPMI 1.0 only). Not supported by CWSDPMI and Windows.

This function allocates a shared memory block that can be accessed from different virtual machines. Fill the required length in info->size_requested. The function fills the rest of the structure: allocated length in info->size, block handle in info->handle, linear address in info->address, and the selector:offset of an ASCIIZ block name (up to 128 bytes long) in info->name_selector and info->name_offset, respectively.

The access to the shared memory block can be serialized by calling the __dpmi_serialize_on_shared_memory function (see section __dpmi_serialize_on_shared_memory).

Return Value

-1 on error, else zero.

Portability

ANSI/ISO C	No
POSIX	No