__dpmi_get_page_attributes

Syntax

#include <dpmi.h> int __dpmi_get_page_attributes(__dpmi_meminfo *info, short *buffer);

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 = 0x0506 (DPMI 1.0 only). Supported by CWSDPMI, but not by Windows.

This function retrieves the attributes of a number of pages. Pass the handle in info->handle, offset of first page (relative to start of block) in info->address, and number of pages in info->count. The buffer buffer gets filled in with the attributes. For each page, a 16-bit attribute word in buffer defines the attributes of that page as follows:

bits 0-2

Page type:

000

uncommitted

001

committed

010

mapped

bit 3

If set, the page is read/write. If cleared, the page is read-only.

bit 4

If set, bits 5 and 6 specify accessed and dirty bits.

bit 5

The page has been accessed (only valid if bit 4 is set).

bit 6

The page has been written (is dirty). Only valid if bit 4 is set.

Return Value

-1 on error, else zero.

Portability

ANSI/ISO C	No
POSIX	No