Functions



arrayFromList

Abstract: Constructs an OSArray of IODeviceMemory instances, each describing one physical range, and a tag value.
public:

static OSArray * arrayFromList( InitElement list[], IOItemCount count );

This method creates IODeviceMemory instances for each physical range passed in a IODeviceMemory::InitElement array. Each element consists of a physical address, length and tag value for the IODeviceMemory. The instances are returned as a created OSArray.

Parameters

NameDescription
listAn array of IODeviceMemory::InitElement structures.
countThe number of elements in the list.
Result: A created OSArray of IODeviceMemory objects, to be released by the caller, or zero on failure.

withRange

Abstract: Constructs an IODeviceMemory instance, describing one physical range.
public:

static IODeviceMemory * withRange( IOPhysicalAddress start, IOPhysicalLength length );

This method creates IODeviceMemory instance for one physical range passed as a physical address and length. It just calls IOMemoryDescriptor::withPhysicalAddress.

Parameters

NameDescription
addressThe physical address of the first byte in the memory.
withLengthThe length of memory.
Result: The created IODeviceMemory on success, to be released by the caller, or zero on failure.

withRange

Abstract: Constructs an IODeviceMemory instance, describing a subset of an existing IODeviceMemory range.
public:

static IODeviceMemory * withSubRange( IODeviceMemory * of, IOPhysicalAddress offset, IOPhysicalLength length );

This method creates IODeviceMemory instance for a subset of an existing IODeviceMemory range, passed as a physical address offset and length. It just calls IOMemoryDescriptor::withSubRange.

Parameters

NameDescription
ofThe parent IODeviceMemory of which a subrange is to be used for the new descriptor, which will be retained by the subrange IODeviceMemory.
offsetA byte offset into the parent's memory.
lengthThe length of the subrange.
Result: The created IODeviceMemory on success, to be released by the caller, or zero on failure.

© 2000 Apple Computer, Inc. — (Last Updated 2/23/2000)