www.delorie.com/djgpp/doc/libc/libc_206.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

__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


  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2004   by DJ Delorie     Updated Apr 2004