Método IHostMAlloc::D ebugAlloc
Solicita que o anfitrião aloque a quantidade especificada de memória da área dinâmica para dados e controle adicionalmente onde a memória foi alocada.
Sintaxe
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, do pedido de alocação de memória atual.
dwCriticalLevel
[in] Um dos valores de EMemoryCriticalLevel , que indica o impacto de uma falha de alocação.
pszFileName
[in] O ficheiro de código do executável que está a ser depurado.
iLineNo
[in] O número de linha em pszFileName
que a alocação foi pedida.
ppMem
[fora] Um ponteiro para a memória alocada ou nulo se não for possível concluir o pedido.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | DebugAlloc devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | Não estava disponível memória suficiente para concluir o pedido de alocação. |
Observações
O CLR obtém um ponteiro de interface para uma instância IHostMalloc ao chamar o método IHostMemoryManager::CreateMalloc . DebugAlloc
permite que o runtime obtenha informações de ficheiro de código para utilização durante a depuração.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0