system.runtime.interopservices

Class SafeBuffer

java.lang.Object

org.mases.jcobridge.netreflection.NetObject

system.runtime.constrainedexecution.CriticalFinalizerObject

system.runtime.interopservices.SafeHandle

microsoft.win32.safehandles.SafeHandleZeroOrMinusOneIsInvalid

system.runtime.interopservices.SafeBuffer

All Implemented Interfaces:

java.lang.AutoCloseable, IJCOBridgeReflected

Direct Known Subclasses:

SafeMemoryMappedViewHandle

public class SafeBuffer
extends SafeHandleZeroOrMinusOneIsInvalid

The base .NET class managing System.Runtime.InteropServices.SafeBuffer, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e.

.NET documentation at https://learn.microsoft.com/dotnet/api/System.Runtime.InteropServices.SafeBuffer

Powered by JCOBridge: more info at https://www.jcobridge.com

Author:

MASES s.r.l https://masesgroup.com

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	assemblyFullName Fully assembly qualified name: System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e
static java.lang.String	assemblyShortName Assembly name: System.Private.CoreLib
static java.lang.String	className Qualified class name: System.Runtime.InteropServices.SafeBuffer
static JCType	classType The type managed from JCOBridge.

Fields inherited from class org.mases.jcobridge.netreflection.NetObject

Null

Constructor Summary

Constructors

Constructor and Description
SafeBuffer()
SafeBuffer(java.lang.Object instance) Internal constructor.

Method Summary

Modifier and Type	Method and Description
static SafeBuffer	cast(IJCOBridgeReflected from) Try to cast the IJCOBridgeReflected instance into SafeBuffer, a cast assert is made to check if types are compatible.
UInt64	getByteLength() Gets the value of the .NET property ByteLength.
java.lang.String	getJCOAssemblyName() Returns the full name of the assembly of the .NET type.
java.lang.String	getJCOClassName() Returns the full name of the .NET type.
java.lang.Object	getJCOInstance() Returns the underlying object managed by the bridge.
java.lang.String	getJCOObjectName() Returns the name of the .NET type qualified with its assembly.
JCType	getJCOType() Returns the JCType of the .NET type.
<T extends IJCOBridgeReflected> void	Initialize(UInt32 numElements) Invokes the .NET member Initialize.
void	Initialize(UInt32 numElements, UInt32 sizeOfEachElement) Invokes the .NET member Initialize.
void	Initialize(UInt64 numBytes) Invokes the .NET member Initialize.
<T extends IJCOBridgeReflected> void	ReadArray(UInt64 byteOffset, T[] array, int index, int count) Invokes the .NET member ReadArray.
void	ReleasePointer() Invokes the .NET member ReleasePointer.
void	setJCOInstance(JCObject instance) Sets the underlying object managed by the bridge.
<T extends IJCOBridgeReflected> void	Write(UInt64 byteOffset, T value) Invokes the .NET member Write.
<T extends IJCOBridgeReflected> void	WriteArray(UInt64 byteOffset, T[] array, int index, int count) Invokes the .NET member WriteArray.

Methods inherited from class system.runtime.interopservices.SafeHandle

close, Close, DangerousAddRef, DangerousRelease, Dispose, getIsClosed, getIsInvalid, SetHandleAsInvalid

Methods inherited from class org.mases.jcobridge.netreflection.NetObject

Equals, Equals, GetHashCode, GetType, hashCode, toString, ToString

Methods inherited from class java.lang.Object

equals, getClass, notify, notifyAll, wait, wait, wait

Field Detail

assemblyFullName

public static final java.lang.String assemblyFullName

Fully assembly qualified name: System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e

See Also:

Constant Field Values

assemblyShortName

public static final java.lang.String assemblyShortName

Assembly name: System.Private.CoreLib

See Also:

Constant Field Values

className

public static final java.lang.String className

Qualified class name: System.Runtime.InteropServices.SafeBuffer

See Also:

Constant Field Values

classType

public static JCType classType

The type managed from JCOBridge. See JCType

Constructor Detail

SafeBuffer

public SafeBuffer()
           throws java.lang.Throwable

Throws:

java.lang.Throwable

SafeBuffer

public SafeBuffer(java.lang.Object instance)
           throws java.lang.Throwable

Internal constructor. Use with caution

Parameters:

instance - the underlying bridge object: it must be a JCObject

Throws:

java.lang.Throwable - if instance is not a JCObject

Method Detail

cast

public static SafeBuffer cast(IJCOBridgeReflected from)
                       throws java.lang.Throwable

Try to cast the IJCOBridgeReflected instance into SafeBuffer, a cast assert is made to check if types are compatible.

Parameters:

from - IJCOBridgeReflected instance to be casted

Returns:

SafeBuffer instance

Throws:

java.lang.Throwable - in case of error during cast operation

getByteLength

public UInt64 getByteLength()
                     throws java.lang.Throwable,
                            ArgumentException,
                            ArgumentOutOfRangeException,
                            ArgumentNullException,
                            InvalidOperationException,
                            PlatformNotSupportedException,
                            ArrayTypeMismatchException,
                            NotSupportedException,
                            CultureNotFoundException,
                            ObjectDisposedException

Gets the value of the .NET property ByteLength.

Returns:

the value of the property

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

CultureNotFoundException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

See Also:

.NET documentation

getJCOAssemblyName

public java.lang.String getJCOAssemblyName()

Description copied from class: NetObject

Returns the full name of the assembly of the .NET type.

Specified by:

getJCOAssemblyName in interface IJCOBridgeReflected

Overrides:

getJCOAssemblyName in class SafeHandleZeroOrMinusOneIsInvalid

Returns:

the full assembly name

getJCOClassName

public java.lang.String getJCOClassName()

Description copied from class: NetObject

Returns the full name of the .NET type.

Specified by:

getJCOClassName in interface IJCOBridgeReflected

Overrides:

getJCOClassName in class SafeHandleZeroOrMinusOneIsInvalid

Returns:

the full class name

getJCOInstance

public java.lang.Object getJCOInstance()

Description copied from class: NetObject

Returns the underlying object managed by the bridge.

Specified by:

getJCOInstance in interface IJCOBridgeReflected

Overrides:

getJCOInstance in class SafeHandleZeroOrMinusOneIsInvalid

Returns:

the underlying object, or null if there is none

getJCOObjectName

public java.lang.String getJCOObjectName()

Description copied from class: NetObject

Returns the name of the .NET type qualified with its assembly.

Specified by:

getJCOObjectName in interface IJCOBridgeReflected

Overrides:

getJCOObjectName in class SafeHandleZeroOrMinusOneIsInvalid

Returns:

the assembly qualified name

getJCOType

public JCType getJCOType()

Description copied from class: NetObject

Returns the JCType of the .NET type.

Specified by:

getJCOType in interface IJCOBridgeReflected

Overrides:

getJCOType in class SafeHandleZeroOrMinusOneIsInvalid

Returns:

the type of the .NET class

Initialize

public <T extends IJCOBridgeReflected> void Initialize(UInt32 numElements)
                                                throws java.lang.Throwable,
                                                       ArgumentException,
                                                       NotSupportedException,
                                                       InvalidOperationException,
                                                       ArgumentOutOfRangeException

Invokes the .NET member Initialize.

Type Parameters:

T - the type of the generic argument T

Parameters:

numElements - the argument of type UInt32

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

See Also:

.NET documentation

Initialize

public void Initialize(UInt32 numElements,
                       UInt32 sizeOfEachElement)
                throws java.lang.Throwable,
                       ArgumentException,
                       ArgumentOutOfRangeException,
                       ArgumentNullException,
                       InvalidOperationException,
                       PlatformNotSupportedException,
                       ArrayTypeMismatchException,
                       NotSupportedException,
                       CultureNotFoundException,
                       ObjectDisposedException

Invokes the .NET member Initialize.

Parameters:

numElements - the argument of type UInt32

sizeOfEachElement - the argument of type UInt32

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

CultureNotFoundException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

See Also:

.NET documentation

Initialize

public void Initialize(UInt64 numBytes)
                throws java.lang.Throwable,
                       ArgumentException,
                       ArgumentOutOfRangeException,
                       ArgumentNullException,
                       InvalidOperationException,
                       PlatformNotSupportedException,
                       ArrayTypeMismatchException,
                       NotSupportedException,
                       IndexOutOfRangeException,
                       RankException,
                       CultureNotFoundException,
                       ObjectDisposedException

Invokes the .NET member Initialize.

Parameters:

numBytes - the argument of type UInt64

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

IndexOutOfRangeException - if the .NET member raises it

RankException - if the .NET member raises it

CultureNotFoundException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

See Also:

.NET documentation

ReadArray

public <T extends IJCOBridgeReflected> void ReadArray(UInt64 byteOffset,
                                                      T[] array,
                                                      int index,
                                                      int count)
                                               throws java.lang.Throwable,
                                                      ArgumentException,
                                                      ArgumentOutOfRangeException,
                                                      PlatformNotSupportedException,
                                                      NotSupportedException,
                                                      ObjectDisposedException,
                                                      InvalidOperationException,
                                                      RankException,
                                                      ArrayTypeMismatchException,
                                                      ArgumentNullException

Invokes the .NET member ReadArray.

Type Parameters:

T - the type of the generic argument T

Parameters:

byteOffset - the argument of type UInt64

array - the argument of type T[]

index - the argument of type int

count - the argument of type int

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

RankException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

See Also:

.NET documentation

ReleasePointer

public void ReleasePointer()
                    throws java.lang.Throwable,
                           ArgumentException,
                           ArgumentOutOfRangeException,
                           ArgumentNullException,
                           InvalidOperationException,
                           PlatformNotSupportedException,
                           ArrayTypeMismatchException,
                           NotSupportedException,
                           CultureNotFoundException,
                           ObjectDisposedException

Invokes the .NET member ReleasePointer.

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

CultureNotFoundException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

See Also:

.NET documentation

setJCOInstance

public void setJCOInstance(JCObject instance)

Description copied from class: NetObject

Sets the underlying object managed by the bridge.

Overrides:

setJCOInstance in class SafeHandleZeroOrMinusOneIsInvalid

Parameters:

instance - the new underlying object

Write

public <T extends IJCOBridgeReflected> void Write(UInt64 byteOffset,
                                                  T value)
                                           throws java.lang.Throwable,
                                                  ArgumentException,
                                                  ArgumentOutOfRangeException,
                                                  ArgumentNullException,
                                                  InvalidOperationException,
                                                  PlatformNotSupportedException,
                                                  ArrayTypeMismatchException,
                                                  NotSupportedException,
                                                  CultureNotFoundException,
                                                  ObjectDisposedException

Invokes the .NET member Write.

Type Parameters:

T - the type of the generic argument T

Parameters:

byteOffset - the argument of type UInt64

value - the argument of type T

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

CultureNotFoundException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

See Also:

.NET documentation

WriteArray

public <T extends IJCOBridgeReflected> void WriteArray(UInt64 byteOffset,
                                                       T[] array,
                                                       int index,
                                                       int count)
                                                throws java.lang.Throwable,
                                                       ArgumentException,
                                                       ArgumentOutOfRangeException,
                                                       PlatformNotSupportedException,
                                                       NotSupportedException,
                                                       ObjectDisposedException,
                                                       InvalidOperationException,
                                                       RankException,
                                                       ArrayTypeMismatchException,
                                                       ArgumentNullException

Invokes the .NET member WriteArray.

Type Parameters:

T - the type of the generic argument T

Parameters:

byteOffset - the argument of type UInt64

array - the argument of type T[]

index - the argument of type int

count - the argument of type int

Throws:

java.lang.Throwable - if the call fails in the bridge or in the CLR

ArgumentException - if the .NET member raises it

ArgumentOutOfRangeException - if the .NET member raises it

PlatformNotSupportedException - if the .NET member raises it

NotSupportedException - if the .NET member raises it

ObjectDisposedException - if the .NET member raises it

InvalidOperationException - if the .NET member raises it

RankException - if the .NET member raises it

ArrayTypeMismatchException - if the .NET member raises it

ArgumentNullException - if the .NET member raises it

See Also:

.NET documentation