SafeBuffer.Initialize Method (UInt32, UInt32)

.NET Framework (current version)

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.

This API is not CLS-compliant.

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

public void Initialize(
	uint numElements,
	uint sizeOfEachElement


Type: System.UInt32

The number of elements in the buffer.

Type: System.UInt32

The size of each element in the buffer.

Exception Condition

numElements is less than zero.


sizeOfEachElement is less than zero.


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

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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1
Return to top