From 4072d20f6e6272f3ca17ede39bc8fffba090facb Mon Sep 17 00:00:00 2001
From: Alistair Leslie-Hughes <leslie_alistair@hotmail.com>
Date: Mon, 19 Sep 2011 12:11:13 +1000
Subject: [PATCH] mscoree: Add .Net debugging interfaces.
---
.gitignore | 1 +
include/Makefile.in | 1 +
include/cordebug.idl | 951 +++++++++++++++++++++++++++++++++++++++++++
3 files changed, 953 insertions(+)
create mode 100644 include/cordebug.idl
diff --git a/.gitignore b/.gitignore
index 8474c43c5a..7855a32750 100644
--- a/.gitignore
+++ b/.gitignore
@@ -146,6 +146,7 @@ include/commoncontrols.h
include/config.h
include/control.h
include/cor.h
+include/cordebug.h
include/ctfutb.h
include/ctxtcall.h
include/d3d10.h
diff --git a/include/Makefile.in b/include/Makefile.in
index c405d64a37..f74eece61f 100644
--- a/include/Makefile.in
+++ b/include/Makefile.in
@@ -18,6 +18,7 @@ PUBLIC_IDL_H_SRCS = \
commoncontrols.idl \
control.idl \
cor.idl \
+ cordebug.idl \
ctfutb.idl \
ctxtcall.idl \
d3d10.idl \
diff --git a/include/cordebug.idl b/include/cordebug.idl
new file mode 100644
index 0000000000..9cde077eaa
--- /dev/null
+++ b/include/cordebug.idl
@@ -0,0 +1,951 @@
+/*
+ * Copyright (C) 2011 Alistair Leslie-Hughes
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+import "unknwn.idl";
+import "objidl.idl";
+
+interface ICorDebugAppDomain;
+interface ICorDebugAppDomainEnum;
+interface ICorDebugAssembly;
+interface ICorDebugAssemblyEnum;
+interface ICorDebugBreakpoint;
+interface ICorDebugBreakpointEnum;
+interface ICorDebugChain;
+interface ICorDebugChainEnum;
+interface ICorDebugClass;
+interface ICorDebugCode;
+interface ICorDebugContext;
+interface ICorDebugEditAndContinueSnapshot;
+interface ICorDebugEditAndContinueErrorInfo;
+interface ICorDebugEnum;
+interface ICorDebugErrorInfoEnum;
+interface ICorDebugEval;
+interface ICorDebugFrame;
+interface ICorDebugFrameEnum;
+interface ICorDebugFunction;
+interface ICorDebugFunctionBreakpoint;
+interface ICorDebugModule;
+interface ICorDebugModuleBreakpoint;
+interface ICorDebugModuleEnum;
+interface ICorDebugObjectEnum;
+interface ICorDebugObjectValue;
+interface ICorDebugProcess;
+interface ICorDebugProcessEnum;
+interface ICorDebugRegisterSet;
+interface ICorDebugStepper;
+interface ICorDebugStepperEnum;
+interface ICorDebugThreadEnum;
+interface ICorDebugUnmanagedCallback;
+interface ICorDebugValueBreakpoint;
+
+
+typedef [wire_marshal(unsigned long)] void *HPROCESS;
+typedef [wire_marshal(unsigned long)] void *HTHREAD;
+
+/* These are defined in corhrd.idl but used here. */
+cpp_quote("#if 0")
+
+typedef UINT32 mdToken;
+typedef mdToken mdModule;
+typedef SIZE_T mdScope;
+typedef mdToken mdTypeDef;
+typedef mdToken mdSourceFile;
+typedef mdToken mdMemberRef;
+typedef mdToken mdMethodDef;
+typedef mdToken mdFieldDef;
+typedef mdToken mdSignature;
+typedef ULONG CorElementType;
+typedef SIZE_T PCCOR_SIGNATURE;
+
+typedef SIZE_T LPDEBUG_EVENT;
+
+typedef SIZE_T LPSTARTUPINFOW;
+typedef SIZE_T LPPROCESS_INFORMATION;
+
+cpp_quote("#endif")
+
+typedef ULONG64 CORDB_ADDRESS;
+typedef ULONG64 CORDB_REGISTER;
+
+
+cpp_quote("#ifndef _COR_IL_MAP")
+cpp_quote("#define _COR_IL_MAP")
+
+typedef struct _COR_IL_MAP
+{
+ ULONG32 oldOffset;
+ ULONG32 newOffset;
+ BOOL fAccurate;
+} COR_IL_MAP;
+
+cpp_quote("#endif /* _COR_IL_MAP */")
+
+cpp_quote("#ifndef _COR_DEBUG_IL_TO_NATIVE_MAP_")
+cpp_quote("#define _COR_DEBUG_IL_TO_NATIVE_MAP_")
+
+typedef enum CorDebugIlToNativeMappingTypes
+{
+ NO_MAPPING = -1,
+ PROLOG = -2,
+ EPILOG = -3
+} CorDebugIlToNativeMappingTypes;
+
+typedef struct COR_DEBUG_IL_TO_NATIVE_MAP
+{
+ ULONG32 ilOffset;
+ ULONG32 nativeStartOffset;
+ ULONG32 nativeEndOffset;
+} COR_DEBUG_IL_TO_NATIVE_MAP;
+
+cpp_quote("#endif /* _COR_DEBUG_IL_TO_NATIVE_MAP_ */")
+
+
+typedef enum CorDebugThreadState
+{
+ THREAD_RUN,
+ THREAD_SUSPEND
+} CorDebugThreadState;
+
+typedef enum CorDebugCreateProcessFlags
+{
+ DEBUG_NO_SPECIAL_OPTIONS = 0x0000
+} CorDebugCreateProcessFlags;
+
+[
+ object,
+ local,
+ uuid(CC7BCAF7-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugValue : IUnknown
+{
+ HRESULT GetType([out] CorElementType *pType);
+ HRESULT GetSize([out] ULONG32 *pSize);
+ HRESULT GetAddress([out] CORDB_ADDRESS *pAddress);
+ HRESULT CreateBreakpoint([out] ICorDebugValueBreakpoint **ppBreakpoint);
+};
+
+[
+ object,
+ local,
+ uuid(938c6d66-7fb6-4f69-b389-425b8987329b),
+ pointer_default(unique)
+]
+interface ICorDebugThread : IUnknown
+{
+ HRESULT GetProcess([out] ICorDebugProcess **ppProcess);
+ HRESULT GetID([out] DWORD *pdwThreadId);
+ HRESULT GetHandle([out] HTHREAD *phThreadHandle);
+ HRESULT GetAppDomain([out] ICorDebugAppDomain **ppAppDomain);
+ HRESULT SetDebugState([in] CorDebugThreadState state);
+ HRESULT GetDebugState([out] CorDebugThreadState *pState);
+
+ typedef enum CorDebugUserState
+ {
+ USER_STOP_REQUESTED = 0x01,
+ USER_SUSPEND_REQUESTED = 0x02,
+ USER_BACKGROUND = 0x04,
+ USER_UNSTARTED = 0x08,
+ USER_STOPPED = 0x10,
+ USER_WAIT_SLEEP_JOIN = 0x20,
+ USER_SUSPENDED = 0x40,
+
+ USER_UNSAFE_POINT = 0x80,
+ } CorDebugUserState;
+
+ HRESULT GetUserState([out] CorDebugUserState *pState);
+ HRESULT GetCurrentException([out] ICorDebugValue **ppExceptionObject);
+ HRESULT ClearCurrentException();
+ HRESULT CreateStepper([out] ICorDebugStepper **ppStepper);
+ HRESULT EnumerateChains([out] ICorDebugChainEnum **ppChains);
+ HRESULT GetActiveChain([out] ICorDebugChain **ppChain);
+ HRESULT GetActiveFrame([out] ICorDebugFrame **ppFrame);
+ HRESULT GetRegisterSet([out] ICorDebugRegisterSet **ppRegisters);
+ HRESULT CreateEval([out] ICorDebugEval **ppEval);
+ HRESULT GetObject([out] ICorDebugValue **ppObject);
+};
+
+[
+ object,
+ local,
+ uuid(3d6f5f62-7538-11d3-8d5b-00104b35e7ef),
+ pointer_default(unique)
+]
+
+interface ICorDebugController : IUnknown
+{
+ HRESULT Stop([in] DWORD dwTimeoutIgnored);
+ HRESULT Continue([in] BOOL fIsOutOfBand);
+ HRESULT IsRunning([out] BOOL *pbRunning);
+ HRESULT HasQueuedCallbacks([in] ICorDebugThread *pThread,
+ [out] BOOL *pbQueued);
+ HRESULT EnumerateThreads([out] ICorDebugThreadEnum **ppThreads);
+ HRESULT SetAllThreadsDebugState([in] CorDebugThreadState state,
+ [in] ICorDebugThread *pExceptThisThread);
+ HRESULT Detach();
+ HRESULT Terminate([in] UINT exitCode);
+ HRESULT CanCommitChanges([in] ULONG cSnapshots,
+ [in] ICorDebugEditAndContinueSnapshot *pSnapshots[],
+ [out] ICorDebugErrorInfoEnum **pError);
+ HRESULT CommitChanges([in] ULONG cSnapshots,
+ [in] ICorDebugEditAndContinueSnapshot *pSnapshots[],
+ [out] ICorDebugErrorInfoEnum **pError);
+};
+
+[
+ object,
+ local,
+ uuid(3d6f5f64-7538-11d3-8d5b-00104b35e7ef),
+ pointer_default(unique)
+]
+interface ICorDebugProcess : ICorDebugController
+{
+ HRESULT GetID([out] DWORD *pdwProcessId);
+ HRESULT GetHandle([out] HPROCESS *phProcessHandle);
+ HRESULT GetThread([in] DWORD dwThreadId, [out] ICorDebugThread **ppThread);
+ HRESULT EnumerateObjects([out] ICorDebugObjectEnum **ppObjects);
+ HRESULT IsTransitionStub([in] CORDB_ADDRESS address, [out] BOOL *pbTransitionStub);
+ HRESULT IsOSSuspended([in] DWORD threadID, [out] BOOL *pbSuspended);
+ HRESULT GetThreadContext([in] DWORD threadID, [in] ULONG32 contextSize,
+ [in, out] BYTE context[]);
+ HRESULT SetThreadContext([in] DWORD threadID, [in] ULONG32 contextSize, [in] BYTE context[]);
+ HRESULT ReadMemory([in] CORDB_ADDRESS address, [in] DWORD size, [out] BYTE buffer[], [out] SIZE_T *read);
+ HRESULT WriteMemory([in] CORDB_ADDRESS address, [in] DWORD size, [in] BYTE buffer[], [out] SIZE_T *written);
+ HRESULT ClearCurrentException([in] DWORD threadID);
+ HRESULT EnableLogMessages([in]BOOL fOnOff);
+ HRESULT ModifyLogSwitch([in] WCHAR *pLogSwitchName,
+ [in]LONG lLevel);
+ HRESULT EnumerateAppDomains([out] ICorDebugAppDomainEnum **ppAppDomains);
+ HRESULT GetObject([out] ICorDebugValue **ppObject);
+ HRESULT ThreadForFiberCookie([in] DWORD fiberCookie, [out] ICorDebugThread **ppThread);
+ HRESULT GetHelperThreadID([out] DWORD *pThreadID);
+};
+
+[
+ object,
+ local,
+ uuid(3d6f5f63-7538-11d3-8d5b-00104b35e7ef),
+ pointer_default(unique)
+]
+interface ICorDebugAppDomain : ICorDebugController
+{
+ HRESULT GetProcess([out] ICorDebugProcess **ppProcess);
+ HRESULT EnumerateAssemblies([out] ICorDebugAssemblyEnum **ppAssemblies);
+ HRESULT GetModuleFromMetaDataInterface([in] IUnknown *pIMetaData,
+ [out] ICorDebugModule **ppModule);
+ HRESULT EnumerateBreakpoints([out] ICorDebugBreakpointEnum **ppBreakpoints);
+ HRESULT EnumerateSteppers([out] ICorDebugStepperEnum **ppSteppers);
+ HRESULT IsAttached([out] BOOL *pbAttached);
+ HRESULT GetName([in] ULONG32 cchName, [out] ULONG32 *pcchName, [out] WCHAR szName[]);
+ HRESULT GetObject([out] ICorDebugValue **ppObject);
+ HRESULT Attach();
+ HRESULT GetID([out] ULONG32 *pId);
+};
+
+[
+ object,
+ local,
+ uuid(3d6f5f60-7538-11d3-8d5b-00104b35e7ef),
+ pointer_default(unique)
+]
+interface ICorDebugManagedCallback : IUnknown
+{
+ HRESULT Breakpoint([in] ICorDebugAppDomain *pAppDomain,
+ [in] ICorDebugThread *pThread,
+ [in] ICorDebugBreakpoint *pBreakpoint);
+
+ typedef enum CorDebugStepReason
+ {
+ STEP_NORMAL,
+ STEP_RETURN,
+ STEP_CALL,
+ STEP_EXCEPTION_FILTER,
+ STEP_EXCEPTION_HANDLER,
+ STEP_INTERCEPT,
+ STEP_EXIT
+ } CorDebugStepReason;
+
+ HRESULT StepComplete([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] ICorDebugStepper *pStepper, [in] CorDebugStepReason reason);
+ HRESULT Break([in] ICorDebugAppDomain *pAppDomain,
+ [in] ICorDebugThread *thread);
+ HRESULT Exception([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] BOOL unhandled);
+ HRESULT EvalComplete([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] ICorDebugEval *pEval);
+ HRESULT EvalException([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] ICorDebugEval *pEval);
+ HRESULT CreateProcess([in] ICorDebugProcess *pProcess);
+ HRESULT ExitProcess([in] ICorDebugProcess *pProcess);
+ HRESULT CreateThread([in] ICorDebugAppDomain *pAppDomain,[in] ICorDebugThread *thread);
+ HRESULT ExitThread([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *thread);
+ HRESULT LoadModule([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugModule *pModule);
+ HRESULT UnloadModule([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugModule *pModule);
+ HRESULT LoadClass([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugClass *c);
+ HRESULT UnloadClass([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugClass *c);
+ HRESULT DebuggerError([in] ICorDebugProcess *pProcess, [in] HRESULT errorHR,
+ [in] DWORD errorCode);
+
+ typedef enum LoggingLevelEnum
+ {
+ LTraceLevel0 = 0,
+ LTraceLevel1,
+ LTraceLevel2,
+ LTraceLevel3,
+ LTraceLevel4,
+ LStatusLevel0 = 20,
+ LStatusLevel1,
+ LStatusLevel2,
+ LStatusLevel3,
+ LStatusLevel4,
+ LWarningLevel = 40,
+ LErrorLevel = 50,
+ LPanicLevel = 100
+ } LoggingLevelEnum;
+
+ typedef enum LogSwitchCallReason
+ {
+ SWITCH_CREATE,
+ SWITCH_MODIFY,
+ SWITCH_DELETE
+ } LogSwitchCallReason;
+
+ HRESULT LogMessage([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] LONG lLevel, [in] WCHAR *pLogSwitchName, [in] WCHAR *pMessage);
+ HRESULT LogSwitch([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] LONG lLevel, [in] ULONG ulReason, [in] WCHAR *pLogSwitchName,
+ [in] WCHAR *pParentName);
+ HRESULT CreateAppDomain([in] ICorDebugProcess *pProcess, [in] ICorDebugAppDomain *pAppDomain);
+ HRESULT ExitAppDomain([in] ICorDebugProcess *pProcess, [in] ICorDebugAppDomain *pAppDomain);
+ HRESULT LoadAssembly([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugAssembly *pAssembly);
+ HRESULT UnloadAssembly([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugAssembly *pAssembly);
+ HRESULT ControlCTrap([in] ICorDebugProcess *pProcess);
+ HRESULT NameChange([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread);
+ HRESULT UpdateModuleSymbols([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugModule *pModule,
+ [in] IStream *pSymbolStream);
+ HRESULT EditAndContinueRemap([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] ICorDebugFunction *pFunction, [in] BOOL fAccurate);
+
+ HRESULT BreakpointSetError([in] ICorDebugAppDomain *pAppDomain, [in] ICorDebugThread *pThread,
+ [in] ICorDebugBreakpoint *pBreakpoint, [in] DWORD dwError);
+};
+
+[
+ object,
+ local,
+ uuid(3d6f5f61-7538-11d3-8d5b-00104b35e7ef),
+ pointer_default(unique)
+]
+interface ICorDebug : IUnknown
+{
+ HRESULT Initialize();
+ HRESULT Terminate();
+ HRESULT SetManagedHandler([in] ICorDebugManagedCallback *pCallback);
+ HRESULT SetUnmanagedHandler([in] ICorDebugUnmanagedCallback *pCallback);
+ HRESULT CreateProcess([in] LPCWSTR lpApplicationName, [in] LPWSTR lpCommandLine,
+ [in] LPSECURITY_ATTRIBUTES lpProcessAttributes,
+ [in] LPSECURITY_ATTRIBUTES lpThreadAttributes,
+ [in] BOOL bInheritHandles, [in] DWORD dwCreationFlags,
+ [in] PVOID lpEnvironment, [in] LPCWSTR lpCurrentDirectory,
+ [in] LPSTARTUPINFOW lpStartupInfo,
+ [in] LPPROCESS_INFORMATION lpProcessInformation,
+ [in] CorDebugCreateProcessFlags debuggingFlags,
+ [out] ICorDebugProcess **ppProcess);
+
+ HRESULT DebugActiveProcess([in] DWORD id, [in] BOOL win32Attach,
+ [out] ICorDebugProcess **ppProcess);
+ HRESULT EnumerateProcesses([out] ICorDebugProcessEnum **ppProcess);
+ HRESULT GetProcess([in] DWORD dwProcessId, [out] ICorDebugProcess **ppProcess);
+ HRESULT CanLaunchOrAttach([in] DWORD dwProcessId, [in] BOOL win32DebuggingEnabled);
+};
+
+
+[
+ object,
+ local,
+ uuid(CC7BCAE8-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugBreakpoint : IUnknown
+{
+ HRESULT Activate([in] BOOL bActive);
+ HRESULT IsActive([out] BOOL *pbActive);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAE9-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugFunctionBreakpoint : ICorDebugBreakpoint
+{
+ HRESULT GetFunction([out] ICorDebugFunction **ppFunction);
+ HRESULT GetOffset([out] ULONG32 *pnOffset);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAEA-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugModuleBreakpoint : ICorDebugBreakpoint
+{
+ HRESULT GetModule([out] ICorDebugModule **ppModule);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAEB-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugValueBreakpoint : ICorDebugBreakpoint
+{
+ HRESULT GetValue([out] ICorDebugValue **ppValue);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAEC-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugStepper : IUnknown
+{
+ HRESULT IsActive([out] BOOL *pbActive);
+ HRESULT Deactivate();
+
+ typedef enum CorDebugIntercept
+ {
+ INTERCEPT_NONE = 0x0 ,
+ INTERCEPT_CLASS_INIT = 0x01,
+ INTERCEPT_EXCEPTION_FILTER = 0x02,
+ INTERCEPT_SECURITY = 0x04,
+ INTERCEPT_CONTEXT_POLICY = 0x08,
+ INTERCEPT_INTERCEPTION = 0x10,
+ INTERCEPT_ALL = 0xffff
+ } CorDebugIntercept;
+
+ HRESULT SetInterceptMask([in] CorDebugIntercept mask);
+
+ typedef enum CorDebugUnmappedStop
+ {
+ STOP_NONE = 0x0,
+ STOP_PROLOG = 0x01,
+ STOP_EPILOG = 0x02,
+ STOP_NO_MAPPING_INFO = 0x04,
+ STOP_OTHER_UNMAPPED = 0x08,
+ STOP_UNMANAGED = 0x10,
+
+ STOP_ALL = 0xffff,
+
+ } CorDebugUnmappedStop;
+
+ HRESULT SetUnmappedStopMask([in] CorDebugUnmappedStop mask);
+ HRESULT Step([in] BOOL bStepIn);
+
+ typedef struct COR_DEBUG_STEP_RANGE
+ {
+ ULONG32 startOffset, endOffset;
+ } COR_DEBUG_STEP_RANGE;
+
+ HRESULT StepRange([in] BOOL bStepIn, [in] COR_DEBUG_STEP_RANGE ranges[], [in] ULONG32 cRangeCount);
+ HRESULT StepOut();
+ HRESULT SetRangeIL([in] BOOL bIL);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB01-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugEnum : IUnknown
+{
+ HRESULT Skip([in] ULONG celt);
+ HRESULT Reset();
+ HRESULT Clone([out] ICorDebugEnum **ppEnum);
+ HRESULT GetCount([out] ULONG *pcelt);
+};
+
+[
+ object,
+ local,
+ uuid(63ca1b24-4359-4883-bd57-13f815f58744),
+ pointer_default(unique)
+]
+
+interface ICorDebugAppDomainEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugAppDomain *values[], [out] ULONG *pceltFetched);
+
+};
+
+[
+ object,
+ local,
+ uuid(4a2a1ec9-85ec-4bfb-9f15-a89fdfe0fe83),
+ pointer_default(unique)
+]
+interface ICorDebugAssemblyEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugAssembly *values[], [out] ULONG *pceltFetched);
+
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB03-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugBreakpointEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugBreakpoint *breakpoints[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB08-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugChainEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugChain *chains[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(F0E18809-72B5-11d2-976F-00A0C9B4D50C),
+ pointer_default(unique)
+]
+interface ICorDebugErrorInfoEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugEditAndContinueErrorInfo *errors[],
+ [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB07-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugFrameEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugFrame *frames[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB09-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugModuleEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugModule *modules[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB02-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugObjectEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] CORDB_ADDRESS objects[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB05-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugProcessEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugProcess *processes[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB04-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugStepperEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugStepper *steppers[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB06-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugThreadEnum : ICorDebugEnum
+{
+ HRESULT Next([in] ULONG celt, [out] ICorDebugThread *threads[], [out] ULONG *pceltFetched);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAEE-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugChain : IUnknown
+{
+ HRESULT GetThread([out] ICorDebugThread **ppThread);
+ HRESULT GetStackRange([out] CORDB_ADDRESS *pStart, [out] CORDB_ADDRESS *pEnd);
+ HRESULT GetContext([out] ICorDebugContext **ppContext);
+ HRESULT GetCaller([out] ICorDebugChain **ppChain);
+ HRESULT GetCallee([out] ICorDebugChain **ppChain);
+ HRESULT GetPrevious([out] ICorDebugChain **ppChain);
+ HRESULT GetNext([out] ICorDebugChain **ppChain);
+ HRESULT IsManaged([out] BOOL *pManaged);
+ HRESULT EnumerateFrames([out] ICorDebugFrameEnum **ppFrames);
+ HRESULT GetActiveFrame([out] ICorDebugFrame **ppFrame);
+ HRESULT GetRegisterSet([out] ICorDebugRegisterSet **ppRegisters);
+ typedef enum CorDebugChainReason
+ {
+ CHAIN_NONE = 0x000,
+ CHAIN_CLASS_INIT = 0x001,
+ CHAIN_EXCEPTION_FILTER = 0x002,
+ CHAIN_SECURITY = 0x004,
+ CHAIN_CONTEXT_POLICY = 0x008,
+ CHAIN_INTERCEPTION = 0x010,
+ CHAIN_PROCESS_START = 0x020,
+ CHAIN_THREAD_START = 0x040,
+ CHAIN_ENTER_MANAGED = 0x080,
+ CHAIN_ENTER_UNMANAGED = 0x100,
+ CHAIN_DEBUGGER_EVAL = 0x200,
+ CHAIN_CONTEXT_SWITCH = 0x400,
+ CHAIN_FUNC_EVAL = 0x800,
+ } CorDebugChainReason;
+
+ HRESULT GetReason([out] CorDebugChainReason *pReason);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAEF-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugFrame : IUnknown
+{
+ HRESULT GetChain([out] ICorDebugChain **ppChain);
+ HRESULT GetCode([out] ICorDebugCode **ppCode);
+ HRESULT GetFunction([out] ICorDebugFunction **ppFunction);
+ HRESULT GetFunctionToken([out] mdMethodDef *pToken);
+ HRESULT GetStackRange([out] CORDB_ADDRESS *pStart, [out] CORDB_ADDRESS *pEnd);
+ HRESULT GetCaller([out] ICorDebugFrame **ppFrame);
+ HRESULT GetCallee([out] ICorDebugFrame **ppFrame);
+ HRESULT CreateStepper([out] ICorDebugStepper **ppStepper);
+};
+
+
+[
+ object,
+ local,
+ uuid(CC7BCB0B-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugRegisterSet : IUnknown
+{
+ typedef enum CorDebugRegister
+ {
+ REGISTER_INSTRUCTION_POINTER = 0,
+ REGISTER_STACK_POINTER,
+ REGISTER_FRAME_POINTER,
+
+ REGISTER_X86_EIP = 0,
+ REGISTER_X86_ESP,
+ REGISTER_X86_EBP,
+
+ REGISTER_X86_EAX,
+ REGISTER_X86_ECX,
+ REGISTER_X86_EDX,
+ REGISTER_X86_EBX,
+
+ REGISTER_X86_ESI,
+ REGISTER_X86_EDI,
+
+ REGISTER_X86_FPSTACK_0,
+ REGISTER_X86_FPSTACK_1,
+ REGISTER_X86_FPSTACK_2,
+ REGISTER_X86_FPSTACK_3,
+ REGISTER_X86_FPSTACK_4,
+ REGISTER_X86_FPSTACK_5,
+ REGISTER_X86_FPSTACK_6,
+ REGISTER_X86_FPSTACK_7,
+
+ REGISTER_AMD64_RIP = 0,
+ REGISTER_AMD64_RSP,
+ REGISTER_AMD64_RBP,
+
+ REGISTER_AMD64_RAX,
+ REGISTER_AMD64_RCX,
+ REGISTER_AMD64_RDX,
+ REGISTER_AMD64_RBX,
+
+ REGISTER_AMD64_RSI,
+ REGISTER_AMD64_RDI,
+
+ REGISTER_AMD64_R8,
+ REGISTER_AMD64_R9,
+ REGISTER_AMD64_R10,
+ REGISTER_AMD64_R11,
+ REGISTER_AMD64_R12,
+ REGISTER_AMD64_R13,
+ REGISTER_AMD64_R14,
+ REGISTER_AMD64_R15,
+
+ REGISTER_AMD64_XMM0,
+ REGISTER_AMD64_XMM1,
+ REGISTER_AMD64_XMM2,
+ REGISTER_AMD64_XMM3,
+ REGISTER_AMD64_XMM4,
+ REGISTER_AMD64_XMM5,
+ REGISTER_AMD64_XMM6,
+ REGISTER_AMD64_XMM7,
+ REGISTER_AMD64_XMM8,
+ REGISTER_AMD64_XMM9,
+ REGISTER_AMD64_XMM10,
+ REGISTER_AMD64_XMM11,
+ REGISTER_AMD64_XMM12,
+ REGISTER_AMD64_XMM13,
+ REGISTER_AMD64_XMM14,
+ REGISTER_AMD64_XMM15,
+
+ REGISTER_IA64_BSP = REGISTER_FRAME_POINTER,
+
+ REGISTER_IA64_R0 = REGISTER_IA64_BSP + 1,
+ REGISTER_IA64_F0 = REGISTER_IA64_R0 + 128,
+
+ } CorDebugRegister;
+
+ HRESULT GetRegistersAvailable([out] ULONG64 *pAvailable);
+
+ HRESULT GetRegisters([in] ULONG64 mask, [in] ULONG32 regCount,
+ [out] CORDB_REGISTER regBuffer[]);
+ HRESULT SetRegisters([in] ULONG64 mask, [in] ULONG32 regCount,
+ [in] CORDB_REGISTER regBuffer[]);
+ HRESULT GetThreadContext([in] ULONG32 contextSize, [in, out] BYTE context[]);
+ HRESULT SetThreadContext([in] ULONG32 contextSize, [in] BYTE context[]);
+}
+
+[
+ object,
+ local,
+ uuid(CC7BCAF6-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugEval : IUnknown
+{
+ HRESULT CallFunction([in] ICorDebugFunction *pFunction, [in] ULONG32 nArgs,
+ [in] ICorDebugValue *ppArgs[]);
+ HRESULT NewObject([in] ICorDebugFunction *pConstructor, [in] ULONG32 nArgs,
+ [in] ICorDebugValue *ppArgs[]);
+ HRESULT NewObjectNoConstructor([in] ICorDebugClass *pClass);
+ HRESULT NewString([in] LPCWSTR string);
+ HRESULT NewArray([in] CorElementType elementType, [in] ICorDebugClass *pElementClass,
+ [in] ULONG32 rank, [in] ULONG32 dims[], [in] ULONG32 lowBounds[]);
+ HRESULT IsActive([out] BOOL *pbActive);
+ HRESULT Abort();
+ HRESULT GetResult([out] ICorDebugValue **ppResult);
+ HRESULT GetThread([out] ICorDebugThread **ppThread);
+ HRESULT CreateValue([in] CorElementType elementType, [in] ICorDebugClass *pElementClass,
+ [out] ICorDebugValue **ppValue);
+};
+
+[
+ object,
+ local,
+ uuid(6DC3FA01-D7CB-11d2-8A95-0080C792E5D8),
+ pointer_default(unique)
+]
+interface ICorDebugEditAndContinueSnapshot : IUnknown
+{
+ HRESULT CopyMetaData([in] IStream *pIStream, [out] GUID *pMvid);
+ HRESULT GetMvid([out] GUID *pMvid);
+ HRESULT GetRoDataRVA([out] ULONG32 *pRoDataRVA);
+ HRESULT GetRwDataRVA([out] ULONG32 *pRwDataRVA);
+ HRESULT SetPEBytes([in] IStream *pIStream);
+ HRESULT SetILMap([in] mdToken mdFunction, [in] ULONG cMapSize, [in] COR_IL_MAP map[]);
+ HRESULT SetPESymbolBytes([in] IStream *pIStream);
+};
+
+[
+ object,
+ local,
+ uuid(dba2d8c1-e5c5-4069-8c13-10a7c6abf43d),
+ pointer_default(unique)
+]
+interface ICorDebugModule : IUnknown
+{
+ HRESULT GetProcess([out] ICorDebugProcess **ppProcess);
+ HRESULT GetBaseAddress([out] CORDB_ADDRESS *pAddress);
+ HRESULT GetAssembly([out] ICorDebugAssembly **ppAssembly);
+ HRESULT GetName([in] ULONG32 cchName, [out] ULONG32 *pcchName, [out] WCHAR szName[]);
+ HRESULT EnableJITDebugging([in] BOOL bTrackJITInfo, [in] BOOL bAllowJitOpts);
+ HRESULT EnableClassLoadCallbacks([in] BOOL bClassLoadCallbacks);
+ HRESULT GetFunctionFromToken([in] mdMethodDef methodDef, [out] ICorDebugFunction **ppFunction);
+ HRESULT GetFunctionFromRVA([in] CORDB_ADDRESS rva, [out] ICorDebugFunction **ppFunction);
+ HRESULT GetClassFromToken([in] mdTypeDef typeDef, [out] ICorDebugClass **ppClass);
+ HRESULT CreateBreakpoint([out] ICorDebugModuleBreakpoint **ppBreakpoint);
+ HRESULT GetEditAndContinueSnapshot([out] ICorDebugEditAndContinueSnapshot **ppEditAndContinueSnapshot);
+ HRESULT GetMetaDataInterface([in] REFIID riid, [out] IUnknown **ppObj);
+ HRESULT GetToken([out] mdModule *pToken);
+ HRESULT IsDynamic([out] BOOL *pDynamic);
+ HRESULT GetGlobalVariableValue([in] mdFieldDef fieldDef, [out] ICorDebugValue **ppValue);
+ HRESULT GetSize([out] ULONG32 *pcBytes);
+ HRESULT IsInMemory([out] BOOL *pInMemory);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAF5-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugClass : IUnknown
+{
+ HRESULT GetModule([out] ICorDebugModule **pModule);
+ HRESULT GetToken([out] mdTypeDef *pTypeDef);
+ HRESULT GetStaticFieldValue([in] mdFieldDef fieldDef, [in] ICorDebugFrame *pFrame,
+ [out] ICorDebugValue **ppValue);
+};
+
+[
+ object,
+ local,
+ uuid(df59507c-d47a-459e-bce2-6427eac8fd06),
+ pointer_default(unique)
+]
+interface ICorDebugAssembly : IUnknown
+{
+ HRESULT GetProcess([out] ICorDebugProcess **ppProcess);
+ HRESULT GetAppDomain([out] ICorDebugAppDomain **ppAppDomain);
+ HRESULT EnumerateModules([out] ICorDebugModuleEnum **ppModules);
+ HRESULT GetCodeBase([in] ULONG32 cchName, [out] ULONG32 *pcchName, [out] WCHAR szName[]);
+ HRESULT GetName([in] ULONG32 cchName, [out] ULONG32 *pcchName, [out] WCHAR szName[]);
+};
+
+
+[
+ object,
+ local,
+ uuid(CC7BCAF3-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugFunction : IUnknown
+{
+ HRESULT GetModule([out] ICorDebugModule **ppModule);
+ HRESULT GetClass([out] ICorDebugClass **ppClass);
+ HRESULT GetToken([out] mdMethodDef *pMethodDef);
+ HRESULT GetILCode([out] ICorDebugCode **ppCode);
+ HRESULT GetNativeCode([out] ICorDebugCode **ppCode);
+ HRESULT CreateBreakpoint([out] ICorDebugFunctionBreakpoint **ppBreakpoint);
+ HRESULT GetLocalVarSigToken([out] mdSignature *pmdSig);
+ HRESULT GetCurrentVersionNumber([out] ULONG32 *pnCurrentVersion);
+};
+
+[
+ object,
+ local,
+ uuid(5263E909-8CB5-11d3-BD2F-0000F80849BD),
+ pointer_default(unique)
+]
+interface ICorDebugUnmanagedCallback : IUnknown
+{
+ HRESULT DebugEvent([in] LPDEBUG_EVENT pDebugEvent, [in] BOOL fOutOfBand);
+};
+
+[
+ object,
+ local,
+ uuid(8D600D41-F4F6-4cb3-B7EC-7BD164944036),
+ pointer_default(unique)
+]
+interface ICorDebugEditAndContinueErrorInfo : IUnknown
+{
+ HRESULT GetModule([out] ICorDebugModule **ppModule);
+ HRESULT GetToken([out]mdToken *pToken);
+ HRESULT GetErrorCode([out]HRESULT *pHr);
+ HRESULT GetString([in] ULONG32 cchString, [out] ULONG32 *pcchString,
+ [out] WCHAR szString[]);
+}
+
+[
+ object,
+ local,
+ uuid(18AD3D6E-B7D2-11d2-BD04-0000F80849BD),
+ pointer_default(unique)
+]
+interface ICorDebugObjectValue : ICorDebugValue
+{
+ HRESULT GetClass([out] ICorDebugClass **ppClass);
+ HRESULT GetFieldValue([in] ICorDebugClass *pClass, [in] mdFieldDef fieldDef,
+ [out] ICorDebugValue **ppValue);
+ HRESULT GetVirtualMethod([in] mdMemberRef memberRef, [out] ICorDebugFunction **ppFunction);
+ HRESULT GetContext([out] ICorDebugContext **ppContext);
+ HRESULT IsValueClass([out] BOOL *pbIsValueClass);
+ HRESULT GetManagedCopy([out] IUnknown **ppObject);
+ HRESULT SetFromManagedCopy([in] IUnknown *pObject);
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCB00-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugContext : ICorDebugObjectValue
+{
+};
+
+[
+ object,
+ local,
+ uuid(CC7BCAF4-8A68-11d2-983C-0000F808342D),
+ pointer_default(unique)
+]
+interface ICorDebugCode : IUnknown
+{
+ HRESULT IsIL([out] BOOL *pbIL);
+ HRESULT GetFunction([out] ICorDebugFunction **ppFunction);
+ HRESULT GetAddress([out] CORDB_ADDRESS *pStart);
+ HRESULT GetSize([out] ULONG32 *pcBytes);
+ HRESULT CreateBreakpoint([in] ULONG32 offset, [out] ICorDebugFunctionBreakpoint **ppBreakpoint);
+ HRESULT GetCode([in] ULONG32 startOffset, [in] ULONG32 endOffset,
+ [in] ULONG32 cBufferAlloc, [out] BYTE buffer[], [out] ULONG32 *pcBufferSize);
+ HRESULT GetVersionNumber([out] ULONG32 *nVersion);
+ HRESULT GetILToNativeMapping([in] ULONG32 cMap, [out] ULONG32 *pcMap,
+ [out] COR_DEBUG_IL_TO_NATIVE_MAP map[]);
+ HRESULT GetEnCRemapSequencePoints([in] ULONG32 cMap,[out] ULONG32 *pcMap,
+ [out] ULONG32 offsets[]);
+};