1/**
2 * This file is part of the mingw-w64 runtime package.
3 * No warranty is given; refer to the file DISCLAIMER within this package.
4 */
5
6#ifndef _WINHVEMUAPI_H_
7#define _WINHVEMUAPI_H_
8
9#include <apiset.h>
10#include <apisetcconv.h>
11#include <minwindef.h>
12#include <winapifamily.h>
13
14#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
15
16#include <winhvplatformdefs.h>
17
18#if defined(__x86_64__)
19
20typedef union WHV_EMULATOR_STATUS {
21 __C89_NAMELESS struct {
22 UINT32 EmulationSuccessful : 1;
23 UINT32 InternalEmulationFailure : 1;
24 UINT32 IoPortCallbackFailed : 1;
25 UINT32 MemoryCallbackFailed : 1;
26 UINT32 TranslateGvaPageCallbackFailed : 1;
27 UINT32 TranslateGvaPageCallbackGpaIsNotAligned : 1;
28 UINT32 GetVirtualProcessorRegistersCallbackFailed : 1;
29 UINT32 SetVirtualProcessorRegistersCallbackFailed : 1;
30 UINT32 InterruptCausedIntercept : 1;
31 UINT32 GuestCannotBeFaulted : 1;
32 UINT32 Reserved : 22;
33 };
34 UINT32 AsUINT32;
35} WHV_EMULATOR_STATUS;
36
37typedef struct WHV_EMULATOR_MEMORY_ACCESS_INFO {
38 WHV_GUEST_PHYSICAL_ADDRESS GpaAddress;
39 UINT8 Direction;
40 UINT8 AccessSize;
41 UINT8 Data[8];
42} WHV_EMULATOR_MEMORY_ACCESS_INFO;
43
44typedef struct WHV_EMULATOR_IO_ACCESS_INFO {
45 UINT8 Direction;
46 UINT16 Port;
47 UINT16 AccessSize;
48 UINT32 Data;
49} WHV_EMULATOR_IO_ACCESS_INFO;
50
51typedef HRESULT (CALLBACK *WHV_EMULATOR_IO_PORT_CALLBACK)(VOID *Context, WHV_EMULATOR_IO_ACCESS_INFO *IoAccess);
52typedef HRESULT (CALLBACK *WHV_EMULATOR_MEMORY_CALLBACK)(VOID *Context, WHV_EMULATOR_MEMORY_ACCESS_INFO *MemoryAccess);
53typedef HRESULT (CALLBACK *WHV_EMULATOR_GET_VIRTUAL_PROCESSOR_REGISTERS_CALLBACK)(VOID *Context, const WHV_REGISTER_NAME *RegisterNames, UINT32 RegisterCount, WHV_REGISTER_VALUE *RegisterValues);
54typedef HRESULT (CALLBACK *WHV_EMULATOR_SET_VIRTUAL_PROCESSOR_REGISTERS_CALLBACK)(VOID *Context, const WHV_REGISTER_NAME *RegisterNames, UINT32 RegisterCount, const WHV_REGISTER_VALUE *RegisterValues);
55typedef HRESULT (CALLBACK *WHV_EMULATOR_TRANSLATE_GVA_PAGE_CALLBACK)(VOID *Context, WHV_GUEST_VIRTUAL_ADDRESS Gva, WHV_TRANSLATE_GVA_FLAGS TranslateFlags, WHV_TRANSLATE_GVA_RESULT_CODE *TranslationResult, WHV_GUEST_PHYSICAL_ADDRESS *Gpa);
56
57typedef struct WHV_EMULATOR_CALLBACKS {
58 UINT32 Size;
59 UINT32 Reserved;
60 WHV_EMULATOR_IO_PORT_CALLBACK WHvEmulatorIoPortCallback;
61 WHV_EMULATOR_MEMORY_CALLBACK WHvEmulatorMemoryCallback;
62 WHV_EMULATOR_GET_VIRTUAL_PROCESSOR_REGISTERS_CALLBACK WHvEmulatorGetVirtualProcessorRegisters;
63 WHV_EMULATOR_SET_VIRTUAL_PROCESSOR_REGISTERS_CALLBACK WHvEmulatorSetVirtualProcessorRegisters;
64 WHV_EMULATOR_TRANSLATE_GVA_PAGE_CALLBACK WHvEmulatorTranslateGvaPage;
65} WHV_EMULATOR_CALLBACKS;
66
67typedef VOID* WHV_EMULATOR_HANDLE;
68
69#ifdef __cplusplus
70extern "C" {
71#endif
72
73HRESULT WINAPI WHvEmulatorCreateEmulator(const WHV_EMULATOR_CALLBACKS *Callbacks, WHV_EMULATOR_HANDLE *Emulator);
74HRESULT WINAPI WHvEmulatorDestroyEmulator(WHV_EMULATOR_HANDLE Emulator);
75HRESULT WINAPI WHvEmulatorTryIoEmulation(WHV_EMULATOR_HANDLE Emulator, VOID *Context, const WHV_VP_EXIT_CONTEXT *VpContext, const WHV_X64_IO_PORT_ACCESS_CONTEXT *IoInstructionContext, WHV_EMULATOR_STATUS *EmulatorReturnStatus);
76HRESULT WINAPI WHvEmulatorTryMmioEmulation(WHV_EMULATOR_HANDLE Emulator, VOID *Context, const WHV_VP_EXIT_CONTEXT *VpContext, const WHV_MEMORY_ACCESS_CONTEXT *MmioInstructionContext, WHV_EMULATOR_STATUS *EmulatorReturnStatus);
77
78#ifdef __cplusplus
79}
80#endif
81
82#endif /* defined(__x86_64__) */
83
84#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) */
85
86#endif