hello-world example error

[enkomio]

Hi,

I followed the README instructions to build and run the hello-world example, but when I run the final command cargo run --example hello-world I receive the following error:

The procedure entry point WHvMapGpaRange2 could not be located in the dynamic 
link library C:\hyperlight-main\target\debug\examples\hello-world.exe.

[ludfjig]

Thank you for the report! Would you mind sharing what version of windows you are using, and whether you have enabled Hyper-V and Windows Hypervisor Platform in Optional Features? We have a link in our readme detailing how to turn these features on, in case they are turned off

[enkomio]

Hi,

sure, here is the information:

c:\hyperlight-main>systeminfo

Host Name:                 NONAME
OS Name:                   Microsoft Windows 10 Pro
OS Version:                10.0.18362 N/A Build 18362
OS Manufacturer:           Microsoft Corporation
OS Configuration:          Standalone Workstation
OS Build Type:             Multiprocessor Free
Registered Organization:   Microsoft
System Type:               x64-based PC
Processor(s):              1 Processor(s) Installed.
                           [01]: Intel64 Family 6 Model 94 Stepping 3 GenuineIntel ~2701 Mhz
BIOS Version:              Dell Inc. 1.8.3, 10/7/2016
Total Physical Memory:     32,655 MB
Available Physical Memory: 11,160 MB
Virtual Memory: Max Size:  65,423 MB
Virtual Memory: Available: 35,033 MB
Virtual Memory: In Use:    30,390 MB
Page File Location(s):     C:\pagefile.sys
Hotfix(s):                 18 Hotfix(s) Installed.
                           [01]: KB4586878
                           [02]: KB4497165
                           [03]: KB4498523
                           [04]: KB4503308
                           [05]: KB4537759
                           [06]: KB4538674
                           [07]: KB4541338
                           [08]: KB4552152
                           [09]: KB4559309
                           [10]: KB4560959
                           [11]: KB4561600
                           [12]: KB4565554
                           [13]: KB4569073
                           [14]: KB4576751
                           [15]: KB4577670
                           [16]: KB4580325
                           [17]: KB5003306
                           [18]: KB4592449
Hyper-V Requirements:      VM Monitor Mode Extensions: Yes
                           Virtualization Enabled In Firmware: Yes
                           Second Level Address Translation: Yes
                           Data Execution Prevention Available: Yes

c:\hyperlight-main>cargo -V
cargo 1.81.0 (2dbb1af80 2024-08-20)

c:\hyperlight-main>rustup -V
rustup 1.27.1 (54dd3d00f 2024-04-24)
info: This is the version for the rustup toolchain manager, not the rustc compiler.

[danbugs]

related #76

[ludfjig]

@enkomio Thank you for providing the info. Would you also mind providing the steps you take to get the error, because I'm not able to reproduce it. Did you modify any of the code by chance?

[mg27aug]

Hi Team,
We are getting the same issue.
Is this issue resolved or is there any work around for the same?

[yash5730]

I am also getting the same issue in windows. Do we have any workaround which we can use to make that work in windows?
Please help me ASAP

[devigned]

We are looking into this. Stay tuned.

[syntactically]

@mg27aug @yash5730 Are you also using Windows 10? Unfortunately, Hyperlight depends on an API (WHvMapGpaRange2) that was not introduced until later. Can you try using Windows 11 or later, or Windows Server 2022 or later?

[simongdavies]

This issue is caused by hyperlight requiring the WHvMapGpaRange2 API on Windows which does not exist on Windows 10.

As it will be difficult to workaround this we have added a check so that when hyperlight runs on an unsupported Windows version an appropriate error message is returned. This was done in #110 , the documentation was also updated to reflect the fact that only Windows 11/Windows 2022 or later is supported.

One possible workaround may be to try running WSL2 on Windows 10 and then running hyperlight in WSL2.