Поделиться через


Метод IHostMemoryManager::VirtualQuery

Служит логической оболочкой для соответствующей функции Win32. Реализация VirtualQuery Win32 извлекает сведения о диапазоне страниц в виртуальном адресном пространстве вызывающего процесса.

Синтаксис

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

Параметры

lpAddress
[in] Указатель на адрес в виртуальной памяти для запроса.

lpBuffer
[out] Указатель на структуру, содержащую сведения об указанной области памяти.

dwLength
[in] Размер буфера, на который lpBuffer указывает , в байтах.

pResult
[out] Указатель на количество байтов, возвращаемых информационным буфером.

Возвращаемое значение

HRESULT Описание:
S_OK VirtualQuery возвращается успешно.
HOST_E_CLRNOTAVAILABLE Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или обработать вызов.
HOST_E_TIMEOUT Истекло время ожидания звонка.
HOST_E_NOT_OWNER Вызывающий объект не является владельцем блокировки.
HOST_E_ABANDONED Событие было отменено во время ожидания заблокированного потока или волокна.
E_FAIL Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE.

Комментарии

VirtualQuery предоставляет сведения о диапазоне страниц в виртуальном адресном пространстве вызывающего процесса. Эта реализация задает значение pResult параметра в число байтов, возвращаемых в информационном буфере, и возвращает значение HRESULT. В функции Win32 VirtualQuery возвращаемое значение — это размер буфера. Дополнительные сведения см. в документации по платформе Windows.

Важно!

Реализация операционной VirtualQuery системы не приводит к взаимоблокировке и может выполняться до конца со случайными потоками, приостановленными в пользовательском коде. Соблюдайте осторожность при реализации размещенной версии этого метода.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: Включено в качестве ресурса в MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0

См. также раздел