WHvRequestVpciDeviceInterrupt

Memberikan gangguan logis ke partisi yang memiliki perangkat PCI virtual yang ditetapkan.

Syntax

HRESULT
WINAPI
WHvRequestVpciDeviceInterrupt(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT64 LogicalDeviceId,
    _In_ UINT64 MsiAddress,
    _In_ UINT32 MsiData
    );

Parameters

Partition

Tangani ke partisi yang memiliki perangkat PCI virtual.

LogicalDeviceId

Menentukan ID perangkat logis perangkat PCI virtual, seperti yang ditetapkan saat perangkat dibuat.

MsiAddress

Menentukan alamat MSI dari interupsi yang akan dikirimkan, seperti yang dikembalikan oleh WHvMapVpciDeviceInterrupt.

MsiData

Menentukan payload data MSI dari interupsi untuk dikirimkan, seperti yang dikembalikan oleh WHvMapVpciDeviceInterrupt.

Mengembalikan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

Pada x64, jika MsiAddress lebih besar dari 0xFFFFFFFF, fungsi mengembalikan HRESULT_FROM_WIN32(ERROR_HV_INVALID_PARAMETER). Hypervisor melakukan validasi perangkat yang tersisa dan mengganggu.

Remarks

Fungsi ini WHvRequestVpciDeviceInterrupt menegaskan gangguan untuk perangkat yang dibuat dengan gangguan logis diaktifkan. Interupsi diidentifikasi oleh MsiAddress nilai dan MsiData yang dikembalikan oleh WHvMapVpciDeviceInterrupt, dan dikirimkan ke prosesor virtual yang saat ini ditargetkan pemetaan.

Panggilan ini memungkinkan tumpukan virtualisasi menyuntikkan gangguan atas nama perangkat alih-alih mengandalkan sumber daya fisik untuk memberi sinyal. Petakan interupsi dengan WHvMapVpciDeviceInterrupt sebelum meminta pengiriman.

Requirements

Persyaratan Nilai
Windows minimum yang didukung Windows 10, versi 20H2 (x64); Windows 11, versi 24H2, build 26100.3915 (Arm64)
Header WinHvPlatform.h
Perpustakaan WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Baca juga