_malloca

Выделение памяти в стеке.Это версия _alloca со службами расширений безопасности, как описано в разделе Средства безопасности в CRT.

void *_malloca( 
   size_t size 
);

Параметры

  • size
    Байты, предназначенные для выбора из стека.

Возвращаемое значение

_malloca процедура возвращает a void указатель на выделенную область, которая гарантированно подходяще выравнивается для хранения любого типа объекта.If size 0 _malloca выбирает нулевой длины, элемент и возвращает допустимый указатель к данному элементу.

Исключение переполнения стека создается, если пространство не могут быть выбраны.Исключение переполнения стека не является исключения с++. структурированные исключения.Вместо использования обработки исключений С++ необходимо использовать Структурная обработка исключений (ЭТО).

Заметки

_malloca выбирает size байты из стека программы или кучи, если запрос превышает некоторый размер (в байтах), заданной by _ALLOCA_S_THRESHOLD.Различие _malloca и _alloca значение _alloca всегда выбирает в стеке, вне зависимости от размера.Непохоже _alloca, который не требует и не допускает вызова free освободить память, выделенную да _malloca требует использования _freea освободить память.В режиме отладки, _malloca всегда выделяет память из кучи.

Ограничения явно вызывать _malloca в обработчике исключений (EH).Подпрограммы EH, которые выполняются на процессорах x86-class работающие в собственном фрейме памяти: Они выполняют свои задачи в области памяти, которая не основывается на текущем месте расположения указателя стека внешней функции.Наиболее распространенные реализации включают структурированные Windows NT выражения предложения обработки исключений (SEH) и catch C++.Поэтому явно вызов _malloca в любых следовать сценариях приводит к сбою программы во время передачи на вызвать процедуру EH:

  • Windows NT ОНА критерий фильтра исключения: __except(_malloca () )

  • Windows NT ОНА заключительный обработчик исключения: __finally {_malloca () }

  • Выражение предложения catch C++ EH

Однако _malloca может быть вызван непосредственно из подпрограммы EH или из приложение-поставленного обратного вызова, принимающий вызванным одно из перечисленных ранее сценариев EH.

Примечание о безопасностиПримечание по безопасности

Если в Windows XP _malloca вызывается в блоке try-catch, необходимо вызвать _resetstkoflw в блоке catch.

Помимо ограничения при использовании в предыдущем /clr (компиляция среды CLR) параметр _malloca не может быть использовано внутри __except блоки.Дополнительные сведения см. в разделе ограничения /clr.

Требования

Процедура

Обязательный заголовок

_malloca

<malloc.h>

Пример

// crt_malloca_simple.c
#include <stdio.h>
#include <malloc.h>

void Fn()
{
   char * buf = (char *)_malloca( 100 );
   // do something with buf
   _freea( buf );
}

int main()
{
   Fn();
}

// crt_malloca_exception.c
// This program demonstrates the use of
// _malloca and trapping any exceptions
// that may occur.

#include <windows.h>
#include <stdio.h>
#include <malloc.h>

int main()
{
    int     size;
    int     numberRead = 0;
    int     errcode = 0;
    void    *p = NULL;
    void    *pMarker = NULL;

    while (numberRead == 0)
    {
        printf_s("Enter the number of bytes to allocate "
                 "using _malloca: ");
        numberRead = scanf_s("%d", &size);
    }

    // Do not use try/catch for _malloca,
    // use __try/__except, since _malloca throws
    // Structured Exceptions, not C++ exceptions.

    __try
    {
        if (size > 0)
        {
            p =  _malloca( size );
        }
        else
        {
            printf_s("Size must be a positive number.");
        }
        _freea( p );
    }

    // Catch any exceptions that may occur.
    __except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
    {
        printf_s("_malloca failed!\n");

        // If the stack overflows, use this function to restore.
        errcode = _resetstkoflw();
        if (errcode)
        {
            printf("Could not reset the stack!");
            _exit(1);
        }
    };
}

Ввод

1000

Пример результатов выполнения

Enter the number of bytes to allocate using _malloca: 1000

Эквивалент в .NET Framework

Неприменимо. Для c# используйте стандартная функция PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Выделение памяти

calloc

malloc

realloc

_resetstkoflw