_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。

另請參閱

資料對齊方式