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.

Field Summary

private long	base
private java.lang.Runnable	logic
private long	size

Fields inherited from class javax.realtime.ScopedMemory

portal

Fields inherited from class javax.realtime.MemoryArea

constant, heap, id, memoryConsumed, nullClassArr, nullMem, nullObjArr, scoped, shadow

Constructor Summary

VTPhysicalMemory(java.lang.Object type, long size)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, long base, long size)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, long base, long size, java.lang.Runnable logic)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, long size, java.lang.Runnable logic)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, long base, javax.realtime.SizeEstimator size)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, long base, javax.realtime.SizeEstimator size, java.lang.Runnable logic)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, javax.realtime.SizeEstimator size)
Create an instance of VTPhysicalMemory with the given parameters.

VTPhysicalMemory(java.lang.Object type, javax.realtime.SizeEstimator size, java.lang.Runnable logic)
Create an instance of VTPhysicalMemory with the given parameters.

Method Summary

protected void	initNative(long sizeInBytes)
java.lang.String	toString() Creates a string representing the name of this.

Methods inherited from class javax.realtime.ScopedMemory

checkAccess, checkNewInstance, enter, enter, getMaximumSize, getOuterScope, getPortal, getReferenceCount, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, setPortal, setupMemBlock

Methods inherited from class javax.realtime.MemoryArea

bless, enterMemBlock, executeInArea, exitMemBlock, getMemoryArea, memoryConsumed, memoryRemaining, newArray, newArray, newArray, newArray, newInstance, newInstance, newInstance, newInstance, postSetup, preSetup, registerFinal, shadow, size, startMem, stopMem, throwIllegalAssignmentError

Methods inherited from class java.lang.Object

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

Field Detail

base

private long base

size

private long size

logic

private java.lang.Runnable logic

Constructor Detail

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

type - An instance of 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 permission 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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

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

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 permission 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.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

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

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 permission 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.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

type - An instance of 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 permission 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.

MemoryInUseException - The specified memory is already in use.

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

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

base - The physical memory address of the area.

size - A size estimator for shit memory area.

Throws:

java.lang.SecurityException - The application doesn't have permission 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.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

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

base - The physical memory address of the area.

size - A size estimator for shit 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 permission 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.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

type - An instance of 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 shit memory area.

Throws:

java.lang.SecurityException - The application doesn't have permission 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.

MemoryInUseException - The specified memory is already in use.

VTPhysicalMemory

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

Create an instance of VTPhysicalMemory with the given parameters.

Parameters:

type - An instance of 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 shit 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 permission 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.

MemoryInUseException - The specified memory is already in use.

Method Detail

initNative

protected void initNative(long sizeInBytes)

Specified by:

initNative in class MemoryArea

toString

public java.lang.String toString()

Creates a string representing the name of this.

Overrides:

toString in class ScopedMemory

Returns:

A string representing the name of this.