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