Método IHostMAlloc::DebugAlloc

Solicita que o host de alocar a quantidade especificada de memória do heap e Além disso, controlar em que 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 dimensionar, em bytes, a solicitação de alocação de memória corrente.
dwCriticalLevel
[in] Um do 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 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	DebugAlloc retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não há memória insuficiente 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. DebugAlloc permite que o tempo de execução obter informações do arquivo de código para uso durante a depuração.