_aligned_offset_realloc
_aligned_malloc または _aligned_offset_malloc で割り当てられたメモリ ブロックのサイズを変更します。
void * _aligned_offset_realloc(
void *memblock,
size_t size,
size_t alignment,
size_t offset
);
パラメーター
memblock
現在のメモリ ブロックのポインター。size
メモリ割り当てのサイズ。alignment
2. の整数乗する必要がある配置の値。offset
配置を設定するメモリ割り当てのオフセット。
戻り値
_aligned_offset_realloc が再割り当てされる場合 (移動) されるメモリ ブロックの void ポインターを返します。戻り値はバッファーの引数がである場合または特定のNULLサイズにブロックを配置できる使用可能なメモリがないサイズが必要ですNULL。最初のケースでは元のブロックが解放されます。2 回目には元のブロックは変更されません。適切にどの型のオブジェクトを格納するために配置されることが保証されるストレージ領域の戻り値へのポインター。null 以外の型へのポインターを取得するには戻り値の型キャストを使用してください。
_aligned_offset_realloc はグローバル変数を変更しないように関数が保証できない返されたポインターが JIT エイリアス化したことを意味するのマークされた __declspec(noalias) と __declspec(restrict) です。詳細についてはnoalias と 制限します。 を参照してください。
解説
_aligned_offset_malloc と同様に構造体を _aligned_offset_realloc 構造内のオフセットに配置します。
_aligned_offset_realloc は malloc に基づいています。_aligned_offset_malloc の使用方法の詳細についてはmalloc を参照してください。memblock が NULL と内部的に関数呼び出し _aligned_offset_malloc。
メモリ割り当てに失敗したり要求が _HEAP_MAXREQ サイズよりも大きい場合は関数のセット errnoENOMEMこの。errno の詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。また_aligned_offset_realloc はパラメーターを検証します。alignment が 2 の累乗でないかoffset が size 以上でまたはゼロ以外の場合この関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、この関数は NULL を返し、errno を EINVAL に設定します。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_aligned_offset_realloc |
<malloc.h> |
使用例
詳細については_aligned_malloc を参照してください。