_malloca

Przydziela pamięć na stosie. Ta funkcja jest wersją z ulepszeniami zabezpieczeń _alloca zgodnie z opisem w temacie Funkcje zabezpieczeń w narzędziu CRT.

Składnia

void *_malloca(
   size_t size
);

Parametry

size
Bajty, które mają zostać przydzielone ze stosu.

Wartość zwracana

Rutyna _malloca zwraca void wskaźnik do przydzielonego miejsca, który jest odpowiednio wyrównany do magazynu dowolnego typu obiektu. Jeśli size wartość to 0, _malloca przydziela element o zerowej długości i zwraca prawidłowy wskaźnik do tego elementu.

Jeśli size wartość jest większa niż _ALLOCA_S_THRESHOLD, próbuje _malloca przydzielić stertę i zwraca wskaźnik o wartości null, jeśli nie można przydzielić miejsca. Jeśli size wartość jest mniejsza lub równa _ALLOCA_S_THRESHOLDwartości , próba _malloca przydzielenia na stosie spowoduje wygenerowanie wyjątku przepełnienia stosu, jeśli nie można przydzielić miejsca. Wyjątek przepełnienia stosu nie jest wyjątkiem języka C++; jest to wyjątek ustrukturyzowany. Zamiast korzystać z obsługi wyjątków w języku C++, należy użyć obsługi wyjątków strukturalnych (SEH), aby przechwycić ten wyjątek.

Uwagi

_malloca przydziela bajty size ze stosu programu lub sterty, jeśli żądanie przekracza określony rozmiar w bajtach podanych przez _ALLOCA_S_THRESHOLD. Różnica między elementami _malloca i _alloca polega na tym, że _alloca zawsze przydziela na stosie, niezależnie od rozmiaru. W przeciwieństwie do _allocametody , która nie wymaga ani nie zezwala na wywołanie w celu free zwolnienia pamięci tak przydzielonej, _malloca wymaga użycia _freea do zwolnienia pamięci. W trybie _malloca debugowania zawsze przydziela pamięć ze sterta.

Istnieją ograniczenia jawnego wywoływania _malloca w programie obsługi wyjątków (EH). Procedury EH uruchamiane na procesorach klasy x86 działają we własnej ramce pamięci: wykonują swoje zadania w przestrzeni pamięci, która nie jest oparta na bieżącej lokalizacji wskaźnika stosu otaczającej funkcji. Najbardziej typowe implementacje obejmują obsługę wyjątków ustrukturyzowanych systemu Windows NT (SEH) i wyrażenia klauzul catch języka C++. W związku z tym jawne wywołanie _malloca w dowolnym z następujących scenariuszy powoduje niepowodzenie programu podczas powrotu do procedury wywołującej EH:

• Wyrażenie filtru wyjątku SEH systemu Windows: __except (_malloca () )

• Ostateczna procedura obsługi wyjątków SEH systemu Windows: __finally {_malloca () }

• Wyrażenie klauzuli catch języka C++ EH

_malloca Można jednak wywołać bezpośrednio z poziomu procedury EH lub z wywołania zwrotnego dostarczonego przez aplikację, który jest wywoływany przez jeden z wymienionych wcześniej scenariuszy EH.

Ważne

W systemie Windows, jeśli _malloca jest wywoływany try/catch wewnątrz bloku, należy wywołać _resetstkoflw w bloku catch.

Oprócz powyższych ograniczeń w przypadku korzystania z /clr opcji _malloca (kompilacja środowiska uruchomieniowego języka wspólnego) nie można używać w __except blokach. Aby uzyskać więcej informacji, zobacz /clr Ograniczenia.

Wymagania

Procedura	Wymagany nagłówek
_malloca	<malloc.h>

Przykład: _malloca

// 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();
}

Przykład: _malloca wyjątek

// 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);
        }
    };
}

Dane wejściowe

1000

Przykładowe dane wyjściowe

Enter the number of bytes to allocate using _malloca: 1000

Zobacz też

Alokacja pamięci
calloc
malloc
realloc
_resetstkoflw