NativeMemory.AlignedAlloc(UIntPtr, UIntPtr) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
重要
この 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の力である必要があります。
返品
割り当てられたメモリ ブロックへのポインター。
- 属性
例外
alignment は 2 の累乗ではありません。
alignmentでのメモリのbyteCountの割り当てに失敗しました。
注釈
このメソッドを使用すると、 byteCount を 0 でき、逆参照してはいけない有効なポインターが返され、メモリ リークを回避するために free に渡す必要があります。
このメソッドは、C aligned_alloc API または Win32 の _aligned_malloc などのプラットフォームに依存するアラインアロケーション API に対するシン ラッパーです。
このメソッドは、 Free(Void*) または Realloc(Void*, UIntPtr)と互換性がありません。 代わりに、 AlignedFree(Void*) または AlignedRealloc(Void*, UIntPtr, UIntPtr)を呼び出します。