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


__dpmi_allocate_shared_memory

Syntax

#include <dpmi.h>

int __dpmi_allocate_shared_memory(__dpmi_shminfo *info);

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 = 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

not ANSI, not POSIX


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