Metodo IHostMAlloc::DebugAlloc
Richiede che l'host alloca la quantità di memoria specificata dall'heap e tiene traccia della posizione in cui è stata allocata la memoria.
Sintassi
HRESULT DebugAlloc (
[in] SIZE_T cbSize,
[in] EMemoryCriticalLevel dwCriticalLevel,
[in] char* pszFileName,
[in] int iLineNo,
[out] void** ppMem
);
Parametri
cbSize
[in] Dimensioni, in byte, della richiesta di allocazione della memoria corrente.
dwCriticalLevel
[in] Uno dei valori EMemoryCriticalLevel , che indica l'impatto di un errore di allocazione.
pszFileName
[in] File di codice del file eseguibile in fase di debug.
iLineNo
[in] Numero di riga in pszFileName cui è stata richiesta l'allocazione.
ppMem
[out] Puntatore alla memoria allocata o Null se la richiesta non è stata completata.
Valore restituito
| HRESULT | Descrizione |
|---|---|
| S_OK | DebugAlloc restituito correttamente. |
| HOST_E_CLRNOTAVAILABLE | ClR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata. |
| HOST_E_TIMEOUT | Timeout della chiamata. |
| HOST_E_NOT_OWNER | Il chiamante non possiede il blocco. |
| HOST_E_ABANDONED | Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso. |
| E_FAIL | Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Memoria insufficiente disponibile per completare la richiesta di allocazione. |
Commenti
CLR ottiene un puntatore dell'interfaccia a un'istanza di IHostMalloc chiamando il metodo IHostMemoryManager::CreateMalloc . DebugAlloc consente al runtime di ottenere informazioni sul file di codice da usare durante il debug.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: Incluso come risorsa in MSCorEE.dll
Versioni di .NET Framework: Disponibile da 2.0
