gliu56/WinRing0-1

WinRing0 is a hardware access library for Windows.

What's WinRing0

WinRing0 is a hardware access library for Windows.

Features

WinRing0 library allows x86/x64 Windows applications to access

• I/O port
• MSR (Model-Specific Register)
• PCI

Copyrights

• 2007-2009 hiyohiyo (hiyohiyo@crystalmark.info)

SPECIAL THANKS

• habe (translation support & technical assistance)
• kashiwano masahiro (PCI Debug Library for Win32 (http://www.otto.to/~kasiwano/)
• Yariv Kaplan, WinIo (http://www.internals.com/)
• Patrick (bug patch)

How to Use

Put WinRing0.dll, WinRing0x64.dll, WinRing0.sys, WinRing0x64.sys, and WinRing0.vxd into the directory where your application's executable file resides.

C++

See also sample application.

Load-Time Dynamic Linking

1. Add WinRing0.lib or WinRing0x64.lib to your project.
2. Add #include "OlsApi.h" statement to your source file.
3. Call InitializeOls().
4. Call GetDllStatus() to check error.
5. Call the library's functions.
6. Call DeinitializeOls().

Reference : Load-Time Dynamic Linking (MSDN)

Run-Time Dynamic Linking

1. Add #include "OlsApiInit.h" statement to your source file.
2. Call InitOpenLibSys().
3. Call GetDllStatus() to check error.
4. Call the library's functions. *
5. Call DeinitOpenLibSys().

*If you would like to call the library's functions on other source files, you should add #include "OlsApiInitExt.h" statement to the source files.

Reference : Run-Time Dynamic Linking (MSDN)

C#

See also sample application.

1. Put OpenLibSys.cs into your project.
2. Add using OpenLibSys; statement to your source file.
3. Call GetStatus() and GetDllStatus() to check error.
4. Call the library's functions.

*Supported platform target is "x86", "x64" and "Any CPU". But WinRing0 does not support "IA64".

How to Build (Requirement)

Sample Code

C++ and C#

Required Visual Studio 2015 Community or higher because of using MFC.

SYS (NT Driver)

Required WDK (Windows Driver Kits)

1. Get WDK from MSDN
2. Install WDK
3. cd WinRing0/source/dll/sys
4. build

VxD (9x Driver)

Required Windows XP SP1 DDK + Win Me support

1. Get Windows XP SP1 DDK from MSDN
2. Install Windows XP SP1 DDK with Win Me support
3. Open "Win Me Free Build Environment"
4. cd WinRing0\source\dll\vxd
5. nmake