Partager via

IHostMAlloc::Alloc, méthode

  • Article

Demande à l’hôte d’allouer la quantité de mémoire spécifiée à partir du tas.

Syntaxe

HRESULT Alloc (  
    [in] SIZE_T  cbSize,
    [in] EMemoryCriticalLevel dwCriticalLevel,
    [out] void** ppMem  
);

Paramètres

cbSize
[in] Taille, en octets, de la demande d’allocation de mémoire actuelle.

dwCriticalLevel
[in] Une des valeurs EMemoryCriticalLevel, indiquant l’impact d’un échec d’allocation.

ppMem
[out] Pointeur vers la mémoire allouée, ou null si la requête n’a pas pu être terminée.

Valeur de retour

HRESULT Description
S_OK Alloc retourné.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Mémoire disponible insuffisante pour finaliser la demande d’allocation.

Notes

Le CLR obtient un pointeur d’interface vers une instance IHostMalloc en appelant la méthode IHostMemoryManager::CreateMalloc.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi