WHvQueryGpaRangeDirtyBitmap

Запрашивает растровое изображение грязной страницы для диапазона гостевых физических адресов.

Синтаксис

HRESULT
WINAPI
WHvQueryGpaRangeDirtyBitmap(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ WHV_GUEST_PHYSICAL_ADDRESS GuestAddress,
    _In_ UINT64 RangeSizeInBytes,
    _Out_writes_bytes_opt_(BitmapSizeInBytes) UINT64* Bitmap,
    _In_ UINT32 BitmapSizeInBytes
    );

Parameters

Partition

Указывает секцию для запроса.

GuestAddress

Указывает гостевой физический адрес начала диапазона для запроса. Этот адрес должен выровняться по страницам.

RangeSizeInBytes

Задает размер диапазона для запроса в байтах.

Bitmap

Если значение не равно NULL, указывает указатель на растровое изображение для записи. Растровое изображение должно быть выровнено по 8 байтам.

BitmapSizeInBytes

Задает размер растрового изображения в байтах. Растровое изображение должно быть достаточно большим, чтобы включить один бит на каждую страницу, округленное до 8-байтового значения.

Если ноль, то Bitmap может иметь значение NULL. Это означает, что грязное состояние диапазона должно быть снято без запроса текущего состояния.

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

Если функция выполнена успешно, возвращается S_OKзначение.

Если указанный диапазон адресов не сопоставлен или не зарегистрирован для отслеживания грязного диапазона, возвращается WHV_E_GPA_RANGE_NOT_FOUNDзначение.

Remarks

Чтобы использовать эту функцию для заданного диапазона адресов, этот диапазон адресов должен быть сопоставлен с WHvMapGpaRangeуказанием флага WHvMapGpaRangeFlagTrackDirtyPages .

Требования

Requirement Ценность
Минимальный поддерживаемый Windows Windows 10 версии 1809 (x64); Windows 11 версии 24H2, сборка 26100.3915 (Arm64)
Header WinHvPlatform.h
Библиотека WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

См. также

  • Last updated on