This documentation is archived and is not being maintained.

SafeBuffer.Initialize Method (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.

This API is not CLS-compliant. 

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

[CLSCompliantAttribute(false)]
public void Initialize(
	uint numElements,
	uint sizeOfEachElement
)

Parameters

numElements
Type: System.UInt32
The number of elements in the buffer.
sizeOfEachElement
Type: System.UInt32
The size of each element in the buffer.

ExceptionCondition
ArgumentOutOfRangeException

numElements is less than zero.

-or-

sizeOfEachElement is less than zero.

-or-

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.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: