IHostMAlloc::DebugAlloc (Método)
Actualización: noviembre 2007
Solicita que el host asigne la cantidad de memoria del montón especificada y, además, que realice el seguimiento de dónde se ha asignado dicha memoria.
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 de EMemoryCriticalLevel, que indica el impacto de un error de asignación.pszFileName
[in] Archivo de código del ejecutable que se está depurando.iLineNo
[in] Número de línea de pszFileName en el que se ha solicitado 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 |
CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente. |
HOST_E_TIMEOUT |
Se agotó el tiempo de espera de la llamada. |
HOST_E_NOT_OWNER |
El llamador no posee el bloqueo. |
HOST_E_ABANDONED |
Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole. |
E_FAIL |
Se ha producido un error irrecuperable desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY |
No hay suficiente memoria disponible para satisfacer la solicitud de asignación. |
Comentarios
CLR obtiene un puntero de interfaz a una instancia de IHostMAlloc mediante una llamada al método IHostMemoryManager::CreateMAlloc. DebugAlloc permite al motor en tiempo de ejecución obtener información del archivo de código para usarla durante la depuración.
Requisitos
Plataformas: vea Requisitos de sistema de .NET Framework.
Encabezado: MSCorEE.idl
Biblioteca: Se incluye como recurso en MsCorEE.dll
.NET Framework, versiones: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0