WHvSetupPartition

パーティションを設定します。これにより、実際のパーティションがハイパーバイザーに作成されます。

構文

HRESULT
WINAPI
WHvSetupPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

Parameters

Partition

パーティション オブジェクトへのハンドル。

戻り値

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

この関数は、セットアップ前に必要なパーティション プロパティが適切に構成されていない場合に、 WHV_E_INVALID_PARTITION_CONFIG を返します。

Remarks

WHvSetupPartition関数はパーティションを設定します。これにより、実際のパーティションがハイパーバイザーに作成されます。

WHvSetupPartitionを使用してパーティションを設定する前に、WHvCreatePartitionと、WHvSetPartitionPropertyで構成されたパーティション オブジェクトの初期プロパティを使用してパーティション オブジェクトを作成する必要があります。 パーティションを設定した後、パーティション オブジェクトを他の Windows Hypervisor Platform API に渡すことができます。 Insider Preview ビルド (19H2) 以降では、 WHvSetupPartition 関数の後に次のプロパティを変更できます。 WHvPartitionPropertyCodeExtendedVmExitsWHvPartitionPropertyCodeExceptionExitBitmapWHvPartitionPropertyCodeX64MsrExitBitmapWHvPartitionPropertyCodeCpuidExitList

Arm64 割り込みコントローラーの構成

Arm64 では、 WHvSetupPartition が呼び出される前に、パーティションの割り込みコントローラーを構成する必要があります。

WHvSetupPartitionを呼び出す前に、EmulationMode フィールドがWHvArm64IcEmulationModeGicV3WHV_ARM64_IC_PARAMETERS値を使用して、WHvSetPartitionPropertyを使用してWHvPartitionPropertyCodeArm64IcParameters プロパティを設定します。 割り込みコントローラーが未構成のままの場合、 WHvSetupPartition は失敗し、 WHV_E_INVALID_PARTITION_CONFIGが返されます。 指定する必要がある GICv3 パラメーターについては、 WHV_ARM64_IC_PARAMETERSを参照してください。

Arm64 では、一部のレジスタを実行する前に、各仮想プロセッサで設定する必要もあります。特に、GIC 再頒布器のベース アドレス (WHvArm64RegisterGicrBaseGpa)。 WHvSetVirtualProcessorRegistersを参照してください。

Requirements

こちらも参照ください

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