Crate win_ring0

win_ring0 is a crate for using the winRing0 windows driver.

The winRing0 was developed by OpenLibSys but is forked and maintained OpenHardwareMonitor. It's used to access low level information from your hardware, such as CPU load, fan speeds, temperature sensors, and more.

It is not an asbtraction an layer. You will need to know the specifics of your hardware and its architecture in order to gather information from it.

For more information visit https://github.com/openhardwaremonitor/openhardwaremonitor.

Example

use win_ring0::WinRing0;
 
pub fn main() {
    let mut r0: Box<WinRing0> = Box::from(WinRing0::new());
 
    println!("Installing ring0 driver");
    match r0.install() {
        Ok(()) => { println!("Driver installed"); }
        Err(err) => { println!("Error: {}", err); }
    }
 
    println!("Opening ring0 driver");
    match r0.open() {
        Ok(()) => { println!("Driver opened"); }
        Err(err) => { println!("Error: {}", err); }
    }
 
    println!("Trying to get tjMax value, should work on most Intel CPUs");
    // MSR_TEMPERATURE_TARGET
    let msr = 0x1a2;
    let out = r0.readMsr(msr).unwrap();
 
    let _edx = ((out >> 32) & 0xffffffff) as u32;
    let eax = (out & 0xffffffff) as u32;
    let tj_max = (eax >> 16) & 0xff;
 
    println!("MSR Value: {}", tj_max);
 
    println!("Closing ring0 driver");
    match r0.close() {
        Ok(()) => { println!("Driver closed"); }
        Err(err) => { println!("Error: {}", err); }
    }
 
    println!("Uninstall ring0 driver");
    match r0.uninstall() {
        Ok(()) => { println!("Driver uninstalled"); }
        Err(err) => { println!("Error: {}", err); }
    }    
}

Structs

WinRing0

WinRing0 driver

Enums

IOCTL

Constants

DEVICE_TYPE

The device type is defined by the winRing0 driver. For more information see https://github.com/openhardwaremonitor/openhardwaremonitor/blob/master/External/WinRing0/OlsIoctl.h .