Compartir vía


IHostMAlloc::DebugAlloc (Método)

Solicita que el host asigne la cantidad de memoria especificada desde el montón y además rastrea dónde se asignó la memoria.

Sintaxis

HRESULT DebugAlloc (  
    [in]  SIZE_T  cbSize,
    [in]  EMemoryCriticalLevel dwCriticalLevel,
    [in]  char*   pszFileName,
    [in]  int     iLineNo,
    [out] void**  ppMem  
);  

Parámetros

cbSize
[in] Tamaño, en bytes, de la solicitud de asignación de memoria actual.

dwCriticalLevel
[in] Uno de los valores EMemoryCriticalLevel, que indica el impacto de un error de asignación.

pszFileName
[in] Archivo de código del archivo ejecutable que se está depurando.

iLineNo
[in] Número de línea en el pszFileName que se solicitó la asignación.

ppMem
[out] Puntero a la memoria asignada o null si no se ha podido completar la solicitud.

Valor devuelto

HRESULT Descripción
S_OK DebugAlloc se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY No ha habido suficiente memoria disponible para completar la solicitud de asignación.

Comentarios

CLR obtiene un puntero de interfaz a una instancia de IHostMalloc llamando al método IHostMemoryManager::CreateMalloc. DebugAlloc permite al tiempo de ejecución obtener información del archivo de código para su uso durante la depuración.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también