PM_allocPage

Allocates a page aligned and page sized block of memory

Declaration

void * PMAPI PM_allocPage(
    ibool locked)

Prototype In

pmapi.h

Parameters

locked

True if the memory should be locked down, false if not

 

Return Value

Pointer to the page aligned page of memory allocated, NULL on failure.

Description

This function is used to allocate a single page sized and page aligned block of memory from the operating system. The memory block may be optionally locked in physical memory if the locked parameter is set to true.

This function is mostly used to allocate pages of physical memory that are used to back the AGP memory regions used by graphics drivers. As such there is presently no requirement for the pages allocated by this function to be globally mapped.

See Also

PM_freePage

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com