winsafe 0.0.28

Windows API and GUI in safe, idiomatic Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

#![allow(non_snake_case)]

use crate::co;
use crate::decl::*;
use crate::dwm::ffi;
use crate::ole::privs::*;

/// [`DwmEnableMMCSS`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmenablemmcss)
/// function.
pub fn DwmEnableMMCSS(enable: bool) -> HrResult<()> {
	HrRet(unsafe { ffi::DwmEnableMMCSS(enable as _) }).to_hrresult()
}

/// [`DwmFlush`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmflush)
/// function.
pub fn DwmFlush() -> HrResult<()> {
	HrRet(unsafe { ffi::DwmFlush() }).to_hrresult()
}

/// [`DwmGetColorizationColor`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmgetcolorizationcolor)
/// function.
///
/// Returns the color in the `0xAARRGGBB` format, and whether the color is an
/// opaque blend.
#[must_use]
pub fn DwmGetColorizationColor() -> HrResult<(u32, bool)> {
	let mut colorization = 0u32;
	let mut opaque_blend = 0;

	HrRet(unsafe { ffi::DwmGetColorizationColor(&mut colorization, &mut opaque_blend) })
		.to_hrresult()
		.map(|_| (colorization, opaque_blend != 0))
}

/// [`DwmIsCompositionEnabled`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmiscompositionenabled)
/// function.
#[must_use]
pub fn DwmIsCompositionEnabled() -> HrResult<bool> {
	let mut pf_enabled = 0;
	HrRet(unsafe { ffi::DwmIsCompositionEnabled(&mut pf_enabled) })
		.to_hrresult()
		.map(|_| pf_enabled != 0)
}

/// [`DwmShowContact`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmshowcontact)
/// function.
pub fn DwmShowContact(pointer_id: u32, show_contact: co::DWMSC) -> HrResult<()> {
	HrRet(unsafe { ffi::DwmShowContact(pointer_id, show_contact.raw()) }).to_hrresult()
}