WHvQueryGpaRangeDirtyBitmap

Bir konuk fiziksel adres aralığı için kirli sayfa bit eşlemini sorgular.

Sözdizimi

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

Sorguya alınacak bölümü belirtir.

GuestAddress

Sorgu için aralığın başlangıcının konuk fiziksel adresini belirtir. Bu adres sayfaya hizalanmış olmalıdır.

RangeSizeInBytes

Sorguya alınacak aralığın boyutunu bayt cinsinden belirtir.

Bitmap

NULL değilse, bit eşlem için yazacak bir işaretçi belirtir. Bit eşlem 8 bayt hizalanmış olmalıdır.

BitmapSizeInBytes

Bit eşlem boyutunu bayt cinsinden belirtir. Bit eşlem her sayfa için bir bit içerecek kadar büyük olmalı ve 8 baytlık bir değere yuvarlanmalıdır.

Sıfır ise NULL Bitmap olabilir. Bu, aralığın kirli durumunun geçerli durumu sorgulamadan temizlenmesi gerektiğini gösterir.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri olur S_OK.

Belirtilen adres aralığı eşlenmemişse veya kirli aralık izleme için kaydedilmemişse, dönüş değeri olur WHV_E_GPA_RANGE_NOT_FOUND.

Açıklamalar

Bu işlevi belirli bir adres aralığı için kullanmak için, bu adres aralığı bayrağını WHvMapGpaRangeFlagTrackDirtyPages belirterek ile WHvMapGpaRangeeşlenmelidir.

Requirements

Requirement Değer
Desteklenen en düşük Windows Windows 10, sürüm 1809 (x64); Windows 11, sürüm 24H2, derleme 26100.3915 (Arm64)
Header WinHvPlatform.h
Kütüphane WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Ayrıca bakınız