NativeMemory.AlignedRealloc(Void*, UIntPtr, UIntPtr) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
重要
この API は CLS 準拠ではありません。
指定したサイズとアラインメントのメモリブロックをバイト単位で再割り当てします。
public:
static void* AlignedRealloc(void* ptr, UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedRealloc(void* ptr, UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedRealloc(void* ptr, nuint byteCount, nuint alignment);
[<System.CLSCompliant(false)>]
static member AlignedRealloc : nativeptr<unit> * unativeint * unativeint -> nativeptr<unit>
パラメーター
- ptr
- Void*
以前に割り当てられたメモリ ブロック。
- byteCount
-
UIntPtr
nuint
unativeint
割り当てるブロックのサイズ (バイト単位)。
- alignment
-
UIntPtr
nuint
unativeint
割り当てるブロックのアラインメント (バイト単位)。 これは 2の力である必要があります。
返品
再割り当てされたメモリ ブロックへのポインター。
- 属性
例外
alignment は 2 の累乗ではありません。
alignmentを使用してメモリのbyteCountを再割り当てできませんでした。
注釈
このメソッドは、ptrがnullされている場合にAlignedAlloc(UIntPtr, UIntPtr)として機能します。
このメソッドを使用すると、 byteCount を 0 でき、逆参照してはいけない有効なポインターが返され、メモリ リークを回避するために free に渡す必要があります。
このメソッドは、Win32 の _aligned_realloc など、プラットフォームに依存するアラインされた再割り当て API です。
このメソッドは、 Free(Void*) または Realloc(Void*, UIntPtr)と互換性がありません。 代わりに、 AlignedFree(Void*) または AlignedRealloc(Void*, UIntPtr, UIntPtr)を呼び出します。