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