Musa.Core 0.7.0

Requires NuGet 2.5 or higher.

dotnet add package Musa.Core --version 0.7.0

NuGet\Install-Package Musa.Core -Version 0.7.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Musa.Core" Version="0.7.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Musa.Core" Version="0.7.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Musa.Core" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Musa.Core --version 0.7.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Musa.Core, 0.7.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Musa.Core@0.7.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Musa.Core&version=0.7.0
                    

                            Install as a Cake Addin

#tool nuget:?package=Musa.Core&version=0.7.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Musa.Core

简体中文

Overview

Warning

Musa.Core is in beta.

Musa.Core is a derivative of the low-level API implementation from Musa.Runtime (formerly ucxxrt). It reimplements Kernel32, Advapi32, and other Win32 APIs on top of ntoskrnl in kernel mode.

Architecture

graph TD
    A[Kernel Driver] --> B[MusaCoreStartup]
    B --> C[Musa.Core StaticLibrary]
    C --> D[Musa.CoreLite]
    D --> E[Musa.Veil]
    E --> F[ntoskrnl.exe]
    C --> G[Kernel32 Thunks]
    C --> H[Advapi32 Thunks]
    C --> I[Ntdll Thunks]
    G --> F
    H --> F
    I --> F

Quick Start

NuGet Install

<ItemGroup>
  <PackageReference Include="Musa.Core">
    <Version>0.7.0</Version>
  </PackageReference>
</ItemGroup>

The NuGet package depends on Musa.CoreLite. You can directly include <Veil.h> to access underlying APIs.

DriverEntry Example

NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject, PUNICODE_STRING RegistryPath)
{
    NTSTATUS Status = MusaCoreStartup(DriverObject, RegistryPath, FALSE);
    if (!NT_SUCCESS(Status)) return Status;

    // Kernel32/Advapi32 APIs now available
    WCHAR Dir[MAX_PATH];
    DWORD Len = GetCurrentDirectoryW(MAX_PATH, Dir);

    return Status;
}

Build Requirements

Dependency	Minimum Version
Visual Studio 2022	17.10+
Windows Driver Kit (WDK)	Matching SDK build
Mile.Project.Configurations	1.0.1917

Building from Source

.\BuildAllTargets.cmd

Build artifacts are output to the Publish/ directory.

Implemented Modules

Module	Status
Zw Routines	✅ All available
Rtl Series API	✅ Partial
KernelBase API	✅ Partial
Kernel32 Thunks (Phase 1-6)	✅ Implemented
Advapi32 API	🚧 In Progress

Key Features

Kernel-mode only — exclusively supports KernelMode toolset projects; enforced at consumer build time
NuGet integration — auto-configures header and library paths, injects /INTEGRITYCHECK linker flag
Debug logging — MusaLOG macro outputs DbgPrintEx in Debug builds, no-op in Release

Documentation

System Architecture — component relationships, data flow, service dependencies
Deployment Guide — CI/CD pipeline and NuGet publishing
Configuration Guide — complete build configuration reference
Changelog — version history

License

MIT License

References

systeminformer/phnt
Windows_OS_Internals_Curriculum_Resource_Kit-ACADEMIC
Zw routine resolution approach provided by @xiaobfly

Product	Compatible and additional computed target framework versions.
native	native is compatible.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

- Musa.CoreLite (>= 1.2.2)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Musa.Core:

Package	Downloads
Musa.Runtime Musa.Runtime - 是以 Musa.Core 作为底层支持的微软 MSVC 运行时库。 * 它可以让内核开发者拥有和应用开发者近似的 C++ 开发体验。 Musa.Runtime - Musa.Runtime is a Microsoft MSVC runtime library based on Musa.Core. * It allows kernel developers to have a C++ development experience similar to that of application developers.	17.4K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
0.7.0	470	6/6/2026
0.6.0	364	5/17/2026
0.5.1	397	5/1/2026
0.5.0	383	4/19/2026
0.4.1	957	8/26/2025
0.4.0	702	5/25/2025
0.3.6	748	3/22/2025
0.3.5	614	3/21/2025
0.3.4	931	8/12/2024
0.3.3	686	8/2/2024
0.3.2	762	7/25/2024
0.3.1	738	7/18/2024
0.3.0	689	7/18/2024
0.2.0	836	7/11/2024
0.1.5	648	7/11/2024

v0.7.0: File APIs, XState, path/time fixes