IHostMemoryManager::VirtualQuery (Método)

Artículo
08/10/2011

Actúa como un contenedor lógico para la función correspondiente de Win32. La implementación de Win32 de VirtualQuery recupera información sobre un intervalo de páginas en el espacio virtual de direcciones del proceso de llamada.

HRESULT VirtualQuery (
    [in]  void*    lpAddress,
    [out] void*    lpBuffer,
    [in]  SIZE_T   dwLength,
    [out] SIZE_T*  pResult
);

Parámetros

lpAddress
[in] Puntero a la dirección de la memoria virtual que se va a consultar.
lpBuffer
[out] Puntero a una estructura que contiene información sobre la región de memoria especificada.
dwLength
[in] Tamaño, en bytes, del búfer al que señala lpBuffer.
pResult
[out] Puntero al número de bytes devuelto por el búfer de información.

Valor devuelto

HRESULT	Descripción
S_OK	VirtualQuery finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (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 catastrófico 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.

Comentarios

VirtualQuery ofrece información sobre un intervalo de páginas del espacio de direcciones virtual del proceso que hace la llamada. Esta implementación establece el valor del parámetro pResult en el número de bytes devuelto en el búfer de información, y devuelve un valor HRESULT. En la función de Win32 VirtualQuery, el valor devuelto es el tamaño de búfer. Para obtener más información, consulte la documentación sobre la plataforma Windows.

Importante
La implementación del sistema operativo de VirtualQuery no incurre en interbloqueos y puede ejecutarse hasta su finalización con subprocesos aleatorios suspendidos en el código de usuario.Extreme las precauciones al implementar una versión hospedada de este método.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Referencia

IHostMemoryManager (Interfaz)

Compartir a través de