_aligned_msize

  • Artikel

Mengembalikan ukuran blok memori yang dialokasikan dalam timbunan.

Sintaks

size_t _aligned_msize(
   void *memblock,
   size_t alignment,
   size_t offset
);

Parameter

memblock
Penunjuk ke blok memori.

alignment
Nilai perataan, yang harus berupa kekuatan bilangan bulat 2.

offset
Offset ke dalam alokasi memori untuk memaksa perataan.

Nilai hasil

Mengembalikan ukuran (dalam byte) sebagai bilangan bulat yang tidak ditandatangani.

Keterangan

Fungsi mengembalikan _aligned_msize ukuran, dalam byte, dari blok memori yang dialokasikan oleh panggilan ke _aligned_malloc atau _aligned_realloc. Nilai alignment dan offset harus sama dengan nilai yang diteruskan ke fungsi yang mengalokasikan blok.

Ketika aplikasi ditautkan dengan versi debug pustaka run-time C, _aligned_msize diselesaikan ke _aligned_msize_dbg. Untuk informasi selengkapnya tentang bagaimana tumpukan dikelola selama proses debugging, lihat Tumpukan debug CRT.

Fungsi ini memvalidasi parameternya. Jika memblock adalah penunjuk null atau alignment bukan kekuatan 2, _aligned_msize memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika kesalahan ditangani, fungsi diatur errno ke EINVAL dan mengembalikan -1.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin Header yang diperlukan
_aligned_msize <malloc.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Baca juga

Alokasi memori