WHvSetVpciDevicePowerState

仮想 PCI (VPCI) デバイスの電源状態を変更します。

構文

HRESULT
WINAPI
WHvSetVpciDevicePowerState(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT64 LogicalDeviceId,
    _In_ DEVICE_POWER_STATE PowerState
    );

Parameters

Partition

VPCI デバイスを所有するパーティションへのハンドル。

LogicalDeviceId

VPCI デバイスの論理デバイス識別子を指定します。

PowerState

遷移する電源状態を DEVICE_POWER_STATE 値 (たとえば、 PowerDeviceD0) として指定します。

戻り値

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

Remarks

WHvSetVpciDevicePowerState関数は、VPCI デバイスに関連付けられている PCIe 物理または仮想関数の電源状態の変更を要求します。 MMIO 範囲を WHvMapVpciDeviceMmioRanges にマップするには、デバイスが D0 電源状態である必要があります。 D0 からデバイスを移行すると、デバイスに対して以前に返された MMIO マッピング配列が無効になります。

Requirements

要件 価値
サポートされている最小Windows Windows 10バージョン 20H2 (x64);Windows 11、バージョン 24H2、ビルド 26100.3915 (Arm64)
Header WinHvPlatform.h
図書館 WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64、Arm64

こちらも参照ください