Método de IHostMAlloc::DebugAlloc
Solicita que o host alocar a quantidade especificada de memória do heap e Além disso, controlar onde a memória foi alocada.
HRESULT DebugAlloc (
[in] SIZE_T cbSize,
[in] EMemoryCriticalLevel dwCriticalLevel,
[in] char* pszFileName,
[in] int iLineNo,
[out] void** ppMem
);
Parâmetros
cbSize
[in] O tamanho em bytes, a solicitação de alocação de memória atual.dwCriticalLevel
[in] Dentre as EMemoryCriticalLevel valores, indicando o impacto de uma falha de alocação.pszFileName
[in] O arquivo de código do executável que está sendo depurado.iLineNo
[in] O número de linha na pszFileName onde a alocação foi solicitada.ppMem
[out] Um ponteiro para a memória alocada ou nulo se a solicitação não pôde ser concluída.
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
DebugAllocretornado com êxito. |
HOST_E_CLRNOTAVAILABLE |
O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito. |
HOST_E_TIMEOUT |
A chamada foi esgotado. |
HOST_E_NOT_OWNER |
O chamador não possui o bloqueio. |
HOST_E_ABANDONED |
Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele. |
E_FAIL |
Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY |
Não havia memória disponível suficiente para concluir a solicitação de alocação. |
Comentários
O CLR obtém um ponteiro de interface para um IHostMalloc instância chamando o IHostMemoryManager::CreateMalloc método. DebugAllocpermite que o tempo de execução obter informações do arquivo de código para uso durante a depuração.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0