ダーティ ページ ビットマップに対して、ゲスト物理アドレスの範囲を照会します。
構文
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
ビットマップのサイズをバイト単位で指定します。 ビットマップは、各ページごとに 1 ビットを含めるのに十分な大きさで、8 バイトの値に切り上げる必要があります。
0 の場合、 Bitmap は NULL にすることができます。 これは、現在の状態を照会せずに範囲のダーティ状態をクリアする必要があることを示します。
戻り値
関数が成功した場合、戻り値は S_OK。
指定したアドレス範囲がマップされていないか、ダーティ範囲の追跡に登録されていない場合、戻り値は WHV_E_GPA_RANGE_NOT_FOUND。
Remarks
特定のアドレス範囲に対してこの関数を使用するには、そのアドレス範囲を WHvMapGpaRangeにマップし、 WHvMapGpaRangeFlagTrackDirtyPages フラグを指定する必要があります。
Requirements
| 要件 | 価値 |
|---|---|
| サポートされている最小Windows | Windows 10バージョン 1809 (x64);Windows 11、バージョン 24H2、ビルド 26100.3915 (Arm64) |
| Header | WinHvPlatform.h |
| 図書館 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64、Arm64 |