_aligned_offset_malloc

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Asigna memoria en un límite de alineación especificado.

void * _aligned_offset_malloc(  
   size_t size,   
   size_t alignment,   
   size_t offset  
);  

Parámetros

[in] size
Tamaño de la asignación de memoria solicitada.

[in] alignment
Valor de la alineación, que debe ser un entero potencia de 2.

[in] offset
Desplazamiento en la asignación de memoria para imponer la alineación.

Puntero al bloque de memoria que se asignó o NULL si se produjo un error en la operación.

_aligned_offset_malloc es útil en situaciones en las que la alineación se necesita en un elemento anidado, por ejemplo si se necesitara la alineación en una clase anidada.

_aligned_offset_mallocse basa en malloc; para obtener más información, consulte malloc.

_aligned_offset_malloc está marcado como __declspec(noalias) y __declspec(restrict), lo que significa que se garantiza que la función no modifica variables globales y que el puntero devuelto no tiene alias. Para obtener más información, consulte noalias y restringir.

Esta función establece errno en ENOMEM si se produce un error en la asignación de memoria o si el tamaño solicitado es mayor que _HEAP_MAXREQ. Para obtener más información acerca de errno, consulte errno, _doserrno, _sys_errlist y _sys_nerr. Además, _aligned_offset_malloc valida sus parámetros. Si alignment no es una potencia de 2 o si offset es mayor o igual a size y distinto de cero, esta función invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, la función devuelve NULL y establece errno en EINVAL.

RutinaEncabezado necesario
_aligned_offset_malloc<malloc.h>

Para obtener más información, consulte _aligned_malloc.

Alineación de datos

Mostrar: