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


__dpmi_serialize_on_shared_memory

Syntax

#include <dpmi.h>

int __dpmi_serialize_on_shared_memory(unsigned long handle, int flags);

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

This function serializes access to a shared memory block whose handle is given in handle. The bit-mapped variable flags defines the following bits:

bit 0
If set, return immediately if serialization is unavailable. If cleared, the program is suspended until the serialization becomes available.
bit 1
If set, perform shared serialization. If cleared, perform exclusive serialization.
bits 2-15
Reserved (should be zero).

An exclusive serialization blocks any serialization attempts for the same memory block from other virtual machines. A shared serialization blocks only exclusive serialization attempts from other virtual machines.

Return Value

-1 on error, else zero.

Portability

not ANSI, not POSIX


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