diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 31 |
1 files changed, 30 insertions, 1 deletions
@@ -18,7 +18,7 @@ Instead either use Zeranoe's build script with `make -C [path-to-this-repo] -f M 1. `examples/dpp-template`: plain and stupid ddk C example 2. `examples/dpp-template-cplusplus`: same, but written in C++, including a very complex class and some MT -3. `examples/dpp-template-cplusplus-EASTL`: C++ example w/ (EA)STL integration, basicially everything usable except for SEH, VEH and assertions. +3. `examples/dpp-template-cplusplus-EASTL`: C++ example w/ (EA)STL integration, basicially everything usable except for VEH and assertions. `examples/dpp-template-cplusplus-EASTL` supports `BUILD_NATIVE`! You can build and run it on your native Linux either with the other examples e.g. `make examples`, build only native executables `make -C examples DPP_ROOT="$(realpath .)" BUILD_NATIVE=1` in the top-level directory or directly build it from the examples directory with `make DPP_ROOT="$(realpath ..)" BUILD_NATIVE=1`. @@ -195,6 +195,35 @@ You may reach a point where system functions, intrinsics or built-ins are requir For system functions that can be retrieved via `MmGetSystemRoutineAddress`, you may use `CRT/gen_wrapper.sh` to create wrapper modules. These modules retrieve the desired functions during run-time, but will be available during link-time. An example is `ZwTraceControl`, which gets exported by `ntdll.dll`. Eventually missing intrinsics/built-ins should be placed in `CRT/kcrt.c`. +## Notes on SEH + +There are some limitations regarding the use of MingW's SEH implementation in kernel mode. +You can not use it as you might have been known it from MSVC or MingW. + +Predefined statements `__try`, `__catch`, `__finally`, `__try1`, `__catch1`, etc. do **not** work! + +You need to use something like: + +```C +#include <except.h> + +int handler(_In_ EXCEPTION_POINTERS * ep) +{ + (void)ep; + return EXCEPTION_EXECUTE_HANDLER; +} + +// ... + +__dpptry(handler, unique_identifier) { + *(int *)0 = 0; +} __dppexcept(unique_identifier) { + DbgPrint("%s\n", "Exception caught!"); +} __dpptryend(unique_identifier); +``` + +SEH needs to be improved. Patches are welcome! + ## Known Issues Unfortunately, `eastl::to_string` does not work. See `CRT/eastl_compat.cpp` for more details. |