blob: cfb6a23ec3e9859b52c4eb3eb738d4b61f61aa18 (
plain)
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
50
51
52
53
|
use std::{io, mem, os::windows::io::AsRawHandle, ptr};
use windows_sys::Win32::System::IO::OVERLAPPED;
use crate::sync::Event;
/// Abstraction over `OVERLAPPED`.
///
/// - https://learn.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-overlapped
/// - https://learn.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-createeventw
pub struct Overlapped {
overlapped: OVERLAPPED,
event: Option<Event>,
}
// SAFETY: Both OVERLAPPED and Event is used for async I/O, so this *should* be safe.
unsafe impl Send for Overlapped {}
impl Overlapped {
/// Creates an `OVERLAPPED` object with `hEvent` set.
pub fn new(event: Option<Event>) -> io::Result<Self> {
let mut overlapped = Overlapped {
// SAFETY: OVERLAPPED is a C struct and can safely be zeroed.
overlapped: unsafe { mem::zeroed() },
event: None,
};
overlapped.set_event(event);
Ok(overlapped)
}
/// Borrows the underlying `OVERLAPPED` object.
pub fn as_mut_ptr(&mut self) -> *mut OVERLAPPED {
&mut self.overlapped
}
/// Returns a reference to the associated event.
pub fn get_event(&self) -> Option<&Event> {
self.event.as_ref()
}
/// Sets the event object for the underlying `OVERLAPPED` object (i.e., `hEvent`)
fn set_event(&mut self, event: Option<Event>) {
match event {
Some(event) => {
self.overlapped.hEvent = event.as_raw_handle();
self.event = Some(event);
}
None => {
self.overlapped.hEvent = ptr::null_mut();
self.event = None;
}
}
}
}
|