javax.realtime
Class VTPhysicalMemory

java.lang.Object
  |
  +--javax.realtime.MemoryArea
        |
        +--javax.realtime.ScopedMemory
              |
              +--javax.realtime.VTPhysicalMemory

public class VTPhysicalMemory

extends ScopedMemory

An instance of VTPhysicalMemory allows objects to be allocated from a range of physical memory with particular attributes, determined by their memory type. This memory area has the same restrictive set of assignment rules as ScopedMemory memory areas, and the same performance restrictions as VTMemory.

See Also:

MemoryArea, ScopedMemory, VTMemory, LTMemory, LTPhysicalMemory, ImmortalPhysicalMemory, RealtimeThread, NoHeapRealtimeThread

Constructor Summary

VTPhysicalMemory(java.lang.Object type, long size)

VTPhysicalMemory(java.lang.Object type, long base, long size)

VTPhysicalMemory(java.lang.Object type, long base, long size, java.lang.Runnable logic)

VTPhysicalMemory(java.lang.Object type, long size, java.lang.Runnable logic)

VTPhysicalMemory(java.lang.Object type, long base, SizeEstimator size)

VTPhysicalMemory(java.lang.Object type, long base, SizeEstimator size, java.lang.Runnable logic)

VTPhysicalMemory(java.lang.Object type, SizeEstimator size)

VTPhysicalMemory(java.lang.Object type, SizeEstimator size, java.lang.Runnable logic)

Method Summary

java.lang.String

toString() Returns a user-friendly representation of this ScopedMemory.

Methods inherited from class javax.realtime.ScopedMemory

enter, enter, getMaximumSize, getPortal, getReferenceCount, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, setPortal

Methods inherited from class javax.realtime.MemoryArea

executeInArea, getMemoryArea, memoryConsumed, memoryRemaining, newArray, newInstance, newInstance, size

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size of the area in bytes.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long base,
                        long size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared)

base - The physical memory address of the area.

size - The size of the area in bytes.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given range of memory.

OffsetOutOfBoundsException - The address is invalid.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        SizeEstimator size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - A size estimator for this area.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long base,
                        SizeEstimator size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared)

base - The physical memory address of the area.

size - A size estimator for this memory area.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given range of memory.

OffsetOutOfBoundsException - The address is invalid.

SizeOutOfBoundsException - The size extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size of the area in bytes.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long base,
                        long size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared)

base - The physical memory address of the area.

size - The size of the area in bytes.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given range of memory.

OffsetOutOfBoundsException - The address is invalid.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        SizeEstimator size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - A size estimator for this area.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

VTPhysicalMemory

public VTPhysicalMemory(java.lang.Object type,
                        long base,
                        SizeEstimator size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Parameters:

type - An Object representing the type of memory required (e.g., dma, shared)

base - The physical memory address of the area.

size - A size estimator for this memory area.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given range of memory.

OffsetOutOfBoundsException - The address is invalid.

SizeOutOfBoundsException - The size extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

Method Detail

toString

public java.lang.String toString()

Description copied from class: ScopedMemory

Returns a user-friendly representation of this ScopedMemory.

Overrides:

toString in class ScopedMemory

Following copied from class: javax.realtime.ScopedMemory

Returns:

The string representation