WHvResetPartition

パーティションを初期状態にリセットします。

構文

HRESULT
WINAPI
WHvResetPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

Parameters

Partition

リセットするパーティション オブジェクトへのハンドル。

戻り値

関数が成功した場合、戻り値は S_OK。

パーティションがリセットを許可しない状態の場合、関数は HRESULT_FROM_WIN32(ERROR_INVALID_STATE)を返します。

Remarks

WHvResetPartition関数はパーティションをリセットし、その仮想プロセッサをパーティションが WHvSetupPartition で設定された直後の状態に戻します。 既存の各仮想プロセッサのレジスタ状態が初期値に復元され、保留中の中断、キャンセル、ディスパッチ通知状態などの仮想プロセッサごとの状態がクリアされます。

リセットを実行するために、関数はパーティションのすべての仮想プロセッサをブロックし、パーティション時間を固定します。仮想プロセッサが次に実行されるときに、時刻が再び解凍されます。 既存の仮想プロセッサは削除されるのではなく、その場で再初期化されるため、仮想プロセッサの数とパーティションの構成済みプロパティはリセット時に保持されます。

パーティションをリセットしても、ゲスト物理アドレス (GPA) マッピングが削除されたり、 WHvMapGpaRangeで確立されたバッキング メモリの内容が変更されたりすることはありません。

Requirements

こちらも参照ください

• WHvCreatePartition
• WHvSetupPartition
• WHvDeletePartition
• Windows Hypervisor Platform API Definitions