Metodo IHostMAlloc::DebugAlloc
Richiede all'host di allocare dall'heap la quantità di memoria specificata e di tenere traccia della posizione di allocazione della memoria.
HRESULT DebugAlloc (
[in] SIZE_T cbSize,
[in] EMemoryCriticalLevel dwCriticalLevel,
[in] char* pszFileName,
[in] int iLineNo,
[out] void** ppMem
);
Parametri
cbSize
[in] Dimensione, in byte, della richiesta corrente di allocazione della memoria.dwCriticalLevel
[in] Uno dei valori di EMemoryCriticalLevel, che indica l'impatto di un'allocazione non riuscita.pszFileName
[in] File di codice dell'eseguibile in fase di debug.iLineNo
[in] Numero di riga in pszFileName in cui è stata richiesta l'allocazione.ppMem
[out] Puntatore alla memoria allocata oppure null se non è stato possibile completare la richiesta.
Valore restituito
HRESULT |
Oggetto di descrizione |
|---|---|
S_OK |
DebugAlloc ha restituito correttamente un valore. |
HOST_E_CLRNOTAVAILABLE |
Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata. |
HOST_E_TIMEOUT |
Timeout della chiamata. |
HOST_E_NOT_OWNER |
Il chiamante non è il proprietario del blocco. |
HOST_E_ABANDONED |
Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento. |
E_FAIL |
Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY |
Memoria insufficiente per completare la richiesta di allocazione. |
Note
Il CLR ottiene un puntatore a interfaccia per un'istanza di IHostMalloc chiamando il metodo IHostMemoryManager::CreateMalloc. DebugAlloc consente al runtime di ottenere informazioni sul file di codice per l'utilizzo durante l'esecuzione il debug.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: inclusa come risorsa in MSCorEE.dll
Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0