Skip to content

Latest commit

 

History

History

ucxxrt

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

Actions Status LICENSE LICENSE Windows Visual Studio

UserMode support will be removed starting 03/29/2022. The last version to support UserMode is e2f159f8f, UserMode please use VC-LTL5

1. About

ucxxrt is a open source rutime library which based on MSVC.The highlight of this project is that it can be used in kernel-mode drivers.
It gives you the same experience as user-mode application development in C++ when developing kernel-mode drivers.

Before ucxxrt was born,in order to use C++ on kernel-mode drivers, I use (KTL、ustd、...).

But there are several problems,like it isn't support C++ exception and it cost much time on implementing new features which provided by the latest ISO,then ucxxrt was born.

1.1 Principle

  • In kernel-mode driver mode,forced disable kernel-mode flag by using property sheet ,it makes the compiler support C++ exceptions.
  • Implement the exception functions such as throwcatch. Simulated the exception dispatcher in throw.

1.2 Features

Kernel-mode:

  • support new/delete operators.
  • support C++ exception (/EHsc).
  • support SAFESEH、GS (Buffer Security Check).
  • support STL (not fully).
  • support static objects.

List of features that are not supported at this time↓

1.3 Example

See project unittest for more Infomation.

void Test$ThrowUnknow()
{
    try
    {
        try
        {
            try
            {
                throw std::wstring();
            }
            catch (int& e)
            {
                ASSERT(false);
                LOG(DPFLTR_IHVDRIVER_ID, DPFLTR_ERROR_LEVEL, "Catch Exception: %d\n", e);
            }
        }
        catch (std::string& e)
        {
            ASSERT(false);
            LOG(DPFLTR_IHVDRIVER_ID, DPFLTR_ERROR_LEVEL, "Catch Exception: %s\n", e.c_str());
        }
    }
    catch (...)
    {
        LOG(DPFLTR_IHVDRIVER_ID, DPFLTR_ERROR_LEVEL, "Catch Exception: ...\n");
    }
}

void Test$HashMap()
{
    auto Rand = std::mt19937_64(::rand());
    auto Map = std::unordered_map<uint32_t, std::string>();
    for (auto i = 0u; i < 10; ++i)
    {
        Map[i] = std::to_string(Rand());
    }

    for (const auto& Item : Map)
    {
        LOG(DPFLTR_IHVDRIVER_ID, DPFLTR_ERROR_LEVEL,
            "map[%ld] = %s\n", Item.first, Item.second.c_str());
    }
}

2. Compile

IDE:Visual Studio 2019 or higher

  • git clone https://github.com/MiroKaku/ucxxrt.git
  • Open ucxxrt.sln and compile

3. How to use

  1. Copy ucxxrt/ucxxrt forder to you project directory.
  2. Add the property sheet ucxxrt.props to yor project.

!! note:Rename DriverEntry to DriverMain

usage

4. Reference and Acknowledgement

Thanks to these excellent projects for help me on developing ucxxrt.

5. List of features that are not supported at this time

  • Thread Local Storage (TLS): thread_local、TlsAlloc ...
  • std::thread
  • std::filesystem
  • std::chrono
  • std::stacktrace_entry
  • std::locale
  • std::stream (std::fstream、std::iostream、std::cin、std::cout、std::cerr)
  • std::mutex、std::shared_mutex
  • std::future
  • std::condition_variable
  • std::latch
  • std::semaphore (std::counting_semaphore、std::binary_semaphore)
  • ...