NativeMemory.AlignedAlloc(UIntPtr, UIntPtr) メソッド

定義

重要

この API は CLS 準拠ではありません。

指定したサイズとアラインメントのメモリのアライン済みブロックをバイト単位で割り当てます。

public:
 static void* AlignedAlloc(UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedAlloc(UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedAlloc(nuint byteCount, nuint alignment);
[<System.CLSCompliant(false)>]
static member AlignedAlloc : unativeint * unativeint -> nativeptr<unit>

パラメーター

byteCount
UIntPtr

nuint

unativeint

割り当てるブロックのサイズ (バイト単位)。

alignment
UIntPtr

nuint

unativeint

割り当てるブロックのアラインメント (バイト単位)。 これは 2の力である必要があります。

返品

Void*

割り当てられたメモリ ブロックへのポインター。

属性

例外

alignment は 2 の累乗ではありません。

alignmentでのメモリのbyteCountの割り当てに失敗しました。

注釈

このメソッドを使用すると、 byteCount0 でき、逆参照してはいけない有効なポインターが返され、メモリ リークを回避するために free に渡す必要があります。

このメソッドは、C aligned_alloc API または Win32 の _aligned_malloc などのプラットフォームに依存するアラインアロケーション API に対するシン ラッパーです。

このメソッドは、 Free(Void*) または Realloc(Void*, UIntPtr)と互換性がありません。 代わりに、 AlignedFree(Void*) または AlignedRealloc(Void*, UIntPtr, UIntPtr)を呼び出します。

適用対象