_aligned_offset_malloc
針對指定的對齊界限配置記憶體。
語法
void * _aligned_offset_malloc(
size_t size,
size_t alignment,
size_t offset
);
參數
size
要求的記憶體配置的大小。
alignment
對齊值,必須是 2 的整數冪。
offset
記憶體配置中要強制對齊的位移。
傳回值
已配置之記憶體區塊的指標,或為 NULL
(作業失敗時)。
備註
_aligned_offset_malloc
適用於巢狀元素需要對齊的情況,例如,如果巢狀類別需要對齊時。
_aligned_offset_malloc
是以 為基礎 malloc
,如需詳細資訊,請參閱 malloc
。
_aligned_offset_malloc
標示 __declspec(noalias)
為 和 __declspec(restrict)
,這表示函式保證不會修改全域變數,且傳回的指標不會有別名。 如需詳細資訊,請參閱 noalias
和 restrict
。
若記憶體配置失敗,或是要求的大小大於 errno
,則此函式會將 ENOMEM
設為 _HEAP_MAXREQ
。 如需 的詳細資訊errno
,請參閱errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。 此外,_aligned_offset_malloc
也會驗證其參數。 如果 alignment
不是 2 的電源,或者offset
如果 不是零且大於或等於 size
,則此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL
,並將 errno
設為 EINVAL
。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
常式 | 必要的標頭 |
---|---|
_aligned_offset_malloc |
<malloc.h> |
範例
如需詳細資訊,請參閱_aligned_malloc
。