SafeBuffer.Initialize SafeBuffer.Initialize SafeBuffer.Initialize SafeBuffer.Initialize Method

Definition

Specifies the size of the memory buffer to allocate. You must call this method before you use the SafeBuffer instance.

Overloads

Initialize(UInt64) Initialize(UInt64) Initialize(UInt64) Initialize(UInt64)

Defines the allocation size of the memory region in bytes. You must call this method before you use the SafeBuffer instance.

Initialize(UInt32, UInt32) Initialize(UInt32, UInt32) Initialize(UInt32, UInt32) Initialize(UInt32, UInt32)

Specifies the allocation size of the memory buffer by using the specified number of elements and element size. You must call this method before you use the SafeBuffer instance.

Initialize<T>(UInt32) Initialize<T>(UInt32) Initialize<T>(UInt32) Initialize<T>(UInt32)

Defines the allocation size of the memory region by specifying the number of value types. You must call this method before you use the SafeBuffer instance.

Initialize(UInt64) Initialize(UInt64) Initialize(UInt64) Initialize(UInt64)

Important

This API is not CLS-compliant.

Defines the allocation size of the memory region in bytes. You must call this method before you use the SafeBuffer instance.

public:
 void Initialize(System::UInt64 numBytes);
[System.CLSCompliant(false)]
public void Initialize (ulong numBytes);
member this.Initialize : uint64 -> unit
Public Sub Initialize (numBytes As ULong)

Parameters

numBytes
UInt64 UInt64 UInt64 UInt64

The number of bytes in the buffer.

Exceptions

numBytes is less than zero.

-or-

numBytes is greater than the available address space.

Initialize(UInt32, UInt32) Initialize(UInt32, UInt32) Initialize(UInt32, UInt32) Initialize(UInt32, UInt32)

Important

This API is not CLS-compliant.

Specifies the allocation size of the memory buffer by using the specified number of elements and element size. You must call this method before you use the SafeBuffer instance.

public:
 void Initialize(System::UInt32 numElements, System::UInt32 sizeOfEachElement);
[System.CLSCompliant(false)]
public void Initialize (uint numElements, uint sizeOfEachElement);
member this.Initialize : uint32 * uint32 -> unit
Public Sub Initialize (numElements As UInteger, sizeOfEachElement As UInteger)

Parameters

numElements
UInt32 UInt32 UInt32 UInt32

The number of elements in the buffer.

sizeOfEachElement
UInt32 UInt32 UInt32 UInt32

The size of each element in the buffer.

Exceptions

numElements is less than zero.

-or-

sizeOfEachElement is less than zero.

-or-

numElements multiplied by sizeOfEachElement is greater than the available address space.

Remarks

This method defines the required size of the memory region as the number of elements in an array multiplied by the size of each element.

Initialize<T>(UInt32) Initialize<T>(UInt32) Initialize<T>(UInt32) Initialize<T>(UInt32)

Important

This API is not CLS-compliant.

Defines the allocation size of the memory region by specifying the number of value types. You must call this method before you use the SafeBuffer instance.

public:
generic <typename T>
 where T : value class void Initialize(System::UInt32 numElements);
[System.CLSCompliant(false)]
public void Initialize<T> (uint numElements) where T : struct;
member this.Initialize : uint32 -> unit (requires 'T : struct)
Public Sub Initialize(Of T As Structure) (numElements As UInteger)

Type Parameters

T

The value type to allocate memory for.

Parameters

numElements
UInt32 UInt32 UInt32 UInt32

The number of elements of the value type to allocate memory for.

Exceptions

numElements is less than zero.

-or-

numElements multiplied by the size of each element is greater than the available address space.

Applies to