结构体 Monitor 

pub struct Monitor { /* private fields */ }

表示一个显示监视器。

示例

use windows_capture::monitor::Monitor;
// 主监视器
let primary = Monitor::primary().unwrap();
println!("主监视器: {}", primary.name().unwrap());

use windows_capture::monitor::Monitor;
// 枚举所有活动的监视器
let monitors = Monitor::enumerate().unwrap();
for (i, m) in monitors.iter().enumerate() {
    println!("监视器 #{}: {}", i + 1, m.name().unwrap_or_default());
}

use windows_capture::monitor::Monitor;
// 通过基于 1 的索引选择（例如，第 2 个监视器）
let m2 = Monitor::from_index(2).unwrap();
println!("第二个监视器尺寸: {}x{}", m2.width().unwrap(), m2.height().unwrap());

另请参阅：[crate::settings::TryIntoCaptureItemWithDetails]。

实现

impl Monitor

pub fn primary() -> Result<Self, Error>

返回主监视器。

错误

• Error::NotFound 当找不到主监视器时

pub fn from_index(index: usize) -> Result<Self, Error>

返回指定索引处的监视器。

错误

• Error::IndexIsLowerThanOne 当 index 小于 1 时
• Error::NotFound 当指定 index 处不存在监视器时
• Error::WindowsError 当监视器枚举失败时

pub fn index(&self) -> Result<usize, Error>

返回监视器的基于 1 的索引。

错误

• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 失败时
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备名称失败时
• Error::FailedToParseMonitorIndex 当从设备名称解析数字索引失败时

pub fn name(&self) -> Result<String, Error>

返回监视器的友好名称。

错误

• Error::WindowsError 当 Display Configuration API 调用失败时
• Error::FailedToConvertWindowsString 当将宽字符串转换为 String 失败时
• Error::NameNotFound 当未找到与该监视器匹配的路径/设备名称时

pub fn device_name(&self) -> Result<String, Error>

返回监视器的设备名称（例如 \\.\DISPLAY1）。

错误

• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 失败时
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备名称失败时

pub fn device_string(&self) -> Result<String, Error>

返回监视器的设备字符串（例如 NVIDIA GeForce RTX 4090）。

错误

• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 失败时
• Error::FailedToGetMonitorName 当 EnumDisplayDevicesW 失败时
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备字符串失败时

pub fn refresh_rate(&self) -> Result<u32, Error>

返回监视器的刷新率（以赫兹 Hz 为单位）。

错误

• Error::FailedToGetMonitorSettings 当 EnumDisplaySettingsW 失败时
• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 在解析设备名称时失败
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备名称失败时

pub fn width(&self) -> Result<u32, Error>

返回监视器的宽度（以像素为单位）。

错误

• Error::FailedToGetMonitorSettings 当 EnumDisplaySettingsW 失败时
• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 在解析设备名称时失败
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备名称失败时

pub fn height(&self) -> Result<u32, Error>

返回监视器的高度（以像素为单位）。

错误

• Error::FailedToGetMonitorSettings 当 EnumDisplaySettingsW 失败时
• Error::FailedToGetMonitorInfo 当 GetMonitorInfoW 在解析设备名称时失败
• Error::FailedToConvertWindowsString 当从 UTF-16 转换设备名称失败时

pub fn enumerate() -> Result<Vec<Self>, Error>

返回所有可用监视器的列表。

错误

• Error::WindowsError 当 EnumDisplayMonitors 失败时

pub const fn from_raw_hmonitor(monitor: *mut c_void) -> Self

从原始 HMONITOR 句柄构造 Monitor 实例。

pub const fn as_raw_hmonitor(&self) -> *mut c_void

返回监视器的原始 HMONITOR 句柄。

trait 实现

impl Clone for Monitor

fn clone(&self) -> Monitor

返回该值的副本。 了解更多

fn clone_from(&mut self, source: &Self)

从 source 执行复制赋值。 了解更多

impl Debug for Monitor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化器格式化该值。 了解更多

impl PartialEq for Monitor

fn eq(&self, other: &Monitor) -> bool

测试 self 和 other 的值是否相等，由 == 使用。

fn ne(&self, other: &Rhs) -> bool

测试 !=。默认实现几乎总是足够的，除非有非常充分的理由，否则不应被重写。

impl TryInto<GraphicsCaptureItemType> for Monitor

type Error = Error

在转换出错时返回的类型。

fn try_into(self) -> Result<GraphicsCaptureItemType, Self::Error>

执行转换。

impl Copy for Monitor

impl Eq for Monitor

impl Send for Monitor

impl StructuralPartialEq for Monitor